demote FAQ.md to doc directory

This doc currently has very little content.  Also fix link
text for other content in the doc directory.
Merge pull request #3364 from rolandwalker/doc_demote_faq

demote FAQ.md to doc directory