Date: Sun, 31 Dec 2023 12:51:58 +0100 From: Kolusion K <kolusion@post.com> To: freebsd-doc@freebsd.org Subject: Systematic broken instructions Message-ID: <trinity-3b6d7e1d-7f6a-4f91-9724-79c87b695760-1704023517837@msvc-mesg-gmxus002>
next in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?trinity-3b6d7e1d-7f6a-4f91-9724-79c87b695760-1704023517837>