Some further wording tweaks to additional documentation

Weaken the documentation location to "should" to match previous
behavior.  Change the example of text documentation from TODOs to
FAQs.  Clarify that documentation should be installed elsewhere if
it is used or read by programs, rather than using the ambiguous
term "referenced."