Solved Version-specific editions of the FreeBSD Handbook

[grahamperrin]

en English:

12.3-RELEASE​

<https://docs-legacy.freebsd.org/doc/12.3-RELEASE/usr/local/share/doc/freebsd/en/books/handbook/>

13.0-RELEASE​

<https://docs-legacy.freebsd.org/doc/13.0-RELEASE/usr/local/share/doc/freebsd/en/books/handbook/>

13.1-RELEASE​

<https://docs-legacy.freebsd.org/doc/13.1-RELEASE/usr/local/share/doc/freebsd/en/books/handbook/>

CURRENT​

<https://docs.freebsd.org/en/books/handbook/>

---

From <https://lists.freebsd.org/archives/freebsd-current/2021-September/000561.html>:

… documentation on our web site is mostly for -current, the state of the art of the code base. …

 

[mrbeastie0x19]

Not to upstage you but if you are unaware I might be about to blow your mind.

Since docs are on VCS for every release there is a particular capture:

E.g here is documentation for release 4.6.0

/ · doc

reviews.freebsd.org

 

[grahamperrin]

if you are unaware

The FreeBSD Project is for documentation but lacks a suitable title.

As far as I can tell, the home page link to FreeBSD Documentation | The FreeBSD Project disappeared in May 2021 and so, archives became somewhat obscure.

The abstract of the latest version of the Handbook descibes it as for FreeBSD 13.0-RELEASE, FreeBSD 12.2-RELEASE and FreeBSD 11.4-RELEASE but not (no mention of) CURRENT. There are directions to the archive for previous versions of the Handbook, however – given the coverage specified in the abstract – I doubt that a newcomer would look elsewhere i.e. the archive for a version for 13.0-RELEASE.

---

PS I'm half-tempted to open a bug for the title of the documentation page, but maybe better to wait until PR 257379 is fixed. FreeBSD bug 259371 – Improve Documentation <titles>: Include "Documentation" in titles

 

[fraxamo]

en English:

12.0-RELEASE
<https://docs.freebsd.org/doc/13.0-RELEASE/usr/local/share/doc/freebsd/en/books/handbook/>

13.0-RELEASE
<https://docs.freebsd.org/doc/13.0-RELEASE/usr/local/share/doc/freebsd/en/books/handbook/>

CURRENT
<https://docs.freebsd.org/en/books/handbook/>

---

From <https://lists.freebsd.org/archives/freebsd-current/2021-September/000561.html>:

Is that first link (12.0-RELEASE) correct? It seems to point to 13.0, the same as the next one.

 

[SirDice]

The preamble to the latest version of the Handbook descibes it as for FreeBSD 13.0-RELEASE, FreeBSD 12.2-RELEASE and FreeBSD 11.4-RELEASE but not (no mention of) CURRENT.

The published handbook only deals with supported versions. -CURRENT is not a supported version. That preable should be changed (and various other parts of the handbook) because 11.4 is not supported anymore. So anything that deals with 11 should be removed now. The handbook often lags behind a bit because it's written separately. And, much like everything else on FreeBSD, anyone can submit suggestions or changes.

FreeBSD Documentation Project Primer for New Contributors

Everything you need to know in order to start contributing to the FreeBSD Documentation Project

docs.freebsd.org

 

[astyle]

Is that first link (12.0-RELEASE) correct? It seems to point to 13.0, the same as the next one.

yeah...

 

[grahamperrin]

<https://lists.freebsd.org/archives/freebsd-current/2021-September/000561.html>

 

[grahamperrin]

Is that first link (12.0-RELEASE) correct?

A copy-and-paste error. Thanks for the correction!

 

[grahamperrin]

The published handbook only deals with supported versions. …

<https://docs.freebsd.org/en/books/handbook/cutting-edge/#current-stable> etc..

True, the abstract is misleading.

 

[grahamperrin]

If you wonder why there's PDF alone …

misc/freebsd-doc-*: Update to rev 8539114 from the FreeBSD docset · freebsd/freebsd-ports@c7fe9c0

Note: HTML format build has been disabled until separate localized-only build will work again without requiring the en_US build. Approved by: doceng (implicit)

github.com