Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 04 Dec 2022 11:33:05 +0000
From:      bugzilla-noreply@freebsd.org
To:        doc@FreeBSD.org
Subject:   [Bug 266111] FAQ: minor corrections and improvements, and notes ahead of a holistic rewrite
Message-ID:  <bug-266111-9-W0Zr29DNfd@https.bugs.freebsd.org/bugzilla/>
In-Reply-To: <bug-266111-9@https.bugs.freebsd.org/bugzilla/>
References:  <bug-266111-9@https.bugs.freebsd.org/bugzilla/>

next in thread | previous in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D266111

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=3D2=
652
                   |                            |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.=20

----

Re: comment #1 and comment #2

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


1) Missing keywords include:=20

* 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).=20

Instead, we already have:=20

* Books

=E2=80=93 in the Documentation menu.

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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-266111-9-W0Zr29DNfd>