Date: Mon, 1 Jan 2024 01:28:47 +0100 From: Kolusion K <kolusion@post.com> To: freebsd-doc@freebsd.org Subject: Re: Systematic broken instructions Message-ID: <trinity-a210eebf-4fff-4caf-88f3-d9558c033f94-1704068927215@msvc-mesg-gmxus002>
next in thread | raw e-mail | index | archive | help
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 sy= stematically 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 ins= tructions that don't work. > > For example, section 8.2.2.1. Install GNOME meta package states to execu= te '# pkg install gnome', but '# ' is not part of the command. And the cop= y button next to the command includes the '# ' which it shouldn't. > > The instructions should instead say to execute the command as 'root' use= r. > > Not everyone knows what '#' means. Its probably explained somewhere in t= he thousand page manual but most people don't have time to read it all, an= d they shouldn't have to read it all for something which could easily be e= xplained on the spot. :) > > > Sincerely, > > Kolusion >
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?trinity-a210eebf-4fff-4caf-88f3-d9558c033f94-1704068927215>