Solved FreeBSD Handbook improvement surveys – announcement and background

[grahamperrin]

black on white

▶<https://forums.freebsd.org/posts/564333>

(It's probably out of scope of Pau's work; a better fit with what Sergio is doing.)

 

[grahamperrin]

From yesterday's <https://reviews.freebsd.org/D35108#795740>:

… at least the FreeBSD handbook documentation of freebsd-update appears to be missing a step or two. https://docs.freebsd.org/en/books/handbook/cutting-edge/

Performing Major and Minor Version Upgrades​

– currently chapter 24, section 2, subsection 3. The final paragraph begins:

The upgrade is now complete. …

As far as I can tell, it lacks the advice to restart the OS.

Anything else?

 

[grahamperrin]

… doesn't have a section that explains to the new comers how to do something trivial as formatting a USB pendrive into a FAT32 file systems.
I ended up following this website: https://www.adminbyaccident.com/freebsd/how-to-freebsd/how-to-format-an-usb-drive-on-freebsd/

Also using four commands to format a USB Pendrive looks a little bit cumbersome...

This probably falls under 254191 – Handbook Chapter 18 should include a section describing using exFat filesystems, and FAT32 filesystems.

… directs people to destroy data on da0 …

263746 – Exercise caution before suggesting commands that will destroy data

• primarily for the book of frequently asked questions
• maybe some overlap with the FreeBSD Handbook.

 

[smithi]

This probably falls under 254191 – Handbook Chapter 18 should include a section describing using exFat filesystems, and FAT32 filesystems.



263746 – Exercise caution before suggesting commands that will destroy data

• primarily for the book of frequently asked questions
• maybe some overlap with the FreeBSD Handbook.

In either case, it couldn't hurt to precede such examples with one line (assuming da0):

# gpart show da0  # correct disk?

for confirmation.

 

[grahamperrin]

Handbook general directions survey

… This survey will run until May 9, 2022 11:59:59pm UTC. As it and the first one complement each other, please considering answering it whether or not you answered the first one. …

The question about locating content is not entirely answerable, because there is no index.

 

[astyle]

Survey completed. Takes 10 minutes, even with thinking about the answers. XD

 

[grahamperrin]

As far as I can tell, it lacks the advice to restart the OS.

Hmm, the advice is present, but in a different subsection.

<https://www.freebsd.org/releases/13.1R/installation/#upgrade-binary> is somewhat easier to follow.

Postscript

…:

• 264113 – FreeBSD 13.1-RELEASE Installation Instructions: update
• 264142 – Handbook section 24.2.3; Add "freebsd-update fetch install" step before version upgrade …