Re: Systematic broken instructions

Another idea that I think is better is to bring the sudo package into the base system. This would then mean the FreeBSD Handbook wouldn't need to systematically indicate or state the command requires superuser privileges.

So instead of the FreeBSD Handbook incorrectly stating to execute this...

# pkg install gnome

... The FreeBSD Handbook would instead state to execute this:

sudo pkg install gnome


This way doesn't require the user knowing what '#' means which saves them time, a bad experience, and it makes using FreeBSD more practical.


> Sent: Sunday, December 31, 2023 at 12:51 pm
> From: "Kolusion K" <kolusion@post.com>
> To: freebsd-doc@freebsd.org
> Subject: Systematic broken instructions
>
> 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
>