The link to "state.hightstate" in the 3rd bullet point was not properly formed, so the hyperlink failed to create. Also massaged the paragraphs explaining the difference between the cmd.run and cmd.wait states.
This fixes a warning from new pages not being in a toctree, as well as moves the new FAQ page from the /ref dir to the root.