Add showPromptIfNecessary to the README.

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

Change-Id: I9238ca059f66807b9fe92ec224582c80db4064a6