Add showPromptIfNecessary to the README.

Also, update documentation to remove incorrect information and fix
some typos.