Date: Tue, 7 Sep 2021 18:51:37 +0200 From: Wolfram Schneider <wosch@freebsd.org> To: Mehmet Erol Sanliturk <m.e.sanliturk@gmail.com> Cc: freebsd-current <freebsd-current@freebsd.org> Subject: Re: Move the Handbook into source tree Message-ID: <CAMWY7CCvxfuXbyMd%2BCKXJU-OZmRBEHra5Oe0vmYngfi-mhLQpg@mail.gmail.com> In-Reply-To: <CAOgwaMs_H7mxuqCp2GOJtXhvZVpcC-go_9TtZ7uSeW_kmgNwHg@mail.gmail.com> References: <CAOgwaMs_H7mxuqCp2GOJtXhvZVpcC-go_9TtZ7uSeW_kmgNwHg@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
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@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@FreeBSD.org> https://wolfram.schneider.org
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAMWY7CCvxfuXbyMd%2BCKXJU-OZmRBEHra5Oe0vmYngfi-mhLQpg>