Update FAQ 2.2 with current doc layout and formats.

[pauamma_gundo.com]

Test Plan

make all and eyeball with lynx

[pauamma_gundo.com]

I'm not at all sure I've got the file formats part right. This is derived from observation. Anyone who knows the nuts and bolts of what is generated, please review and correct me if/where/as needed.

[grahamperrin]

Thanks.

Context: https://docs.freebsd.org/en/books/faq/#doc-formats

documentation/content/en/books/faq/_index.adoc

274

language, singular.

274

?

354–355

[pauamma_gundo.com]

Graham Perrin's comments and a few I forgot earlier.

[grahamperrin]

That's probably enough, for now, Phabricator makes my head spin …

documentation/content/en/books/faq/_index.adoc

263

266

267–269

It might have been FTP in the past, but now it's HTTPS, and (I think) in this case, let's not be shy about making the address visible.

270–271

273

274

345

Let's remind ourselves that the page is (or should be) – essentially – answers to questions about FreeBSD.

[pauamma_gundo.com]

In D36976#840540, @grahamperrin wrote:

That's probably enough, for now, Phabricator makes my head spin …

That's OK. (I have a similar problem with Github.) I'm shelving this until doc slush ends anyway.

documentation/content/en/books/faq/_index.adoc

274

Replaced "these" with its new referent.

274

?

Not sure what that 2nd comment is asking.

[pauamma_gundo.com]

documentation/content/en/books/faq/_index.adoc

263

Focusing on the layout question in this review.

267–269

Agreed about not mentioning FTP, not about the URL alone as link text. (On second thought, I don't agree with the original either, for accessibility.)

274

Going to keep the original wording, paralleling "The document's name" above.

345

Will revisit later, along with the rest of the tersifying you suggested.

[pauamma_gundo.com]

Changes following grahamperrin's review.

[pauamma_gundo.com]

ping @gjb @carlavilla

[gjb]

Approved.