Systematic broken instructions

Go to: [ bottom of page ] [ top of archives ] [ this month ]

From: Kolusion K <kolusion_at_post.com>
Date: Sun, 31 Dec 2023 11:51:58 UTC

Hi,


The FreeBSD Handbook has a systematic problem where it gives literal instructions that don't work.

For example, section 8.2.2.1. Install GNOME meta package states to execute '# pkg install gnome', but '# ' is not part of the command. And the copy button next to the command includes the '# ' which it shouldn't.

The instructions should instead say to execute the command as 'root' user.

Not everyone knows what '#' means. Its probably explained somewhere in the thousand page manual but most people don't have time to read it all, and they shouldn't have to read it all for something which could easily be explained on the spot. :)


Sincerely,

Kolusion