more instructions

added more troubleshooting tips, error reporting, and clarified some
instructions