Re: Move the Handbook into source tree

From: Wolfram Schneider <wosch_at_freebsd.org>
Date: Tue, 7 Sep 2021 18:51:37 +0200
We have 3 main repos: src, ports and doc. There are good reasons why
we are doing this, and it will not change in the near future. For
further questions and details, please ask on the freebsd-docs mailing
list.

You are right that the documentation on our web site is mostly for
-current, the state of the art of the code base. If you need the
documentation for our supported releases please check our
Documentation Archive at

 https://docs.freebsd.org/doc/

and select your favourite release, e.g.

the handbook for FreeBSD 13.0
https://docs.freebsd.org/doc/13.0-RELEASE/usr/local/share/doc/freebsd/en/books/handbook/

the handbook for FreeBSD 12.0
https://docs.freebsd.org/doc/12.0-RELEASE/usr/local/share/doc/freebsd/en/books/handbook/

-Wolfram

On Tue, 7 Sept 2021 at 09:03, Mehmet Erol Sanliturk
<m.e.sanliturk_at_gmail.com> wrote:
>
> Dear All ,
>
> in many of my messages to FreeBSD mailing lists I am mentioning the
> following view :
>
>   "Please move the Handbook into source tree , and
>    Maintain it with respect to current release without mixing sliding
> releases : If you do this ,
>    maintenance of a correct Handbook is IMPOSSIBLE because maintenance of
>    associated IF statements about releases .
> "
>
> When we look at the following web pages , we see the following :
>
> https://www.freebsd.org/cgi/man.cgi
> FreeBSD Manual Pages
>
> In the second box of  "All sections" line , there are lines about all of
> the FreeBSD releases
> with many more other systems .
>
> In spite of this , in the following page :
>
> https://docs.freebsd.org/en/books/handbook/
> FreeBSD Handbook
> The FreeBSD Documentation Project
>
>
> "
> Abstract
>
> Welcome to FreeBSD! This handbook covers the installation and day to day
> use of
> FreeBSD 13.0-RELEASE, FreeBSD 12.2-RELEASE and FreeBSD 11.4-RELEASE. ...
> "
>
> A Handbook which ( for me , exactly , for the others , perhaps  ) with many
> errors ...
>
>
> I think that , it is NOT extraordinarily a difficult process to move the
> Handbook into source
> tree and maintaining it with respect to per release and insert into the
> above web page a part
> similar to the manual pages to display the requested Handbook with respect
> to releases .
> In the present case , previous handbooks are lost , because of the
> difficulty of finding them .
>
> Thank you very much and my best wishes for you and humanity in these
> pandemic days ...
>
>
> Mehmet Erol Sanliturk



-- 
Wolfram Schneider <wosch_at_FreeBSD.org> https://wolfram.schneider.org
Received on Tue Sep 07 2021 - 16:51:37 UTC

Original text of this message