[Bug 266111] FAQ: minor corrections and improvements, and notes ahead of a holistic rewrite

From: <bugzilla-noreply_at_freebsd.org>
Date: Sun, 04 Dec 2022 11:33:05 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=266111

Graham Perrin <grahamperrin@freebsd.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
            Summary|FAQ: minor corrections and  |FAQ: minor corrections and
                   |improvements                |improvements, and notes
                   |                            |ahead of a holistic rewrite
           See Also|                            |https://bugs.freebsd.org/bu
                   |                            |gzilla/show_bug.cgi?id=2652
                   |                            |76,
                   |                            |https://reviews.freebsd.org
                   |                            |/D37598

--- Comment #5 from Graham Perrin <grahamperrin@freebsd.org> ---
Think of D37598 as tidiness. Consider the possibility of someone wanting to
reuse a part, elsewhere, before or after retirement of the existing FAQ. 

----

Re: comment #1 and comment #2

Whilst the holistic side of things takes shape – for a new FAQ page – below, a
couple of brief notes (other brief notes may follow). 


1) Missing keywords include: 

* releng


2) <https://docs.freebsd.org/en/books/faq/#books> is redundant and
disorienting. The paragraph directs readers _away_ from the documentation
portal, to a FreeBSD Project page that misuses books (alone) as a link for
documentation (in general). 

Instead, we already have: 

* Books

– in the Documentation menu.

-- 
You are receiving this mail because:
You are on the CC list for the bug.