Date: Wed, 16 Aug 2023 07:35:50 +0000 From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 261349] Modernise hier(7) Message-ID: <bug-261349-9-dEqolDFp1p@https.bugs.freebsd.org/bugzilla/> In-Reply-To: <bug-261349-9@https.bugs.freebsd.org/bugzilla/> References: <bug-261349-9@https.bugs.freebsd.org/bugzilla/>
next in thread | previous in thread | raw e-mail | index | archive | help
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D261349 Alexander Ziaee <concussious.bugzilla@runbox.com> changed: What |Removed |Added ---------------------------------------------------------------------------- CC| |concussious.bugzilla@runbox | |.com --- Comment #43 from Alexander Ziaee <concussious.bugzilla@runbox.com> --- I've been working on modernizing hier(7) too. Freebsd teaches you how to use it, you install it and then the first MOTD s= ays to look at hier(7). I use it since a childhood, and I didn't go into an IT career or school. I started reading % man hier. It searches very well, it's= an index to the system. I can use freebsd because of it. Why unlist active parts of the system? My hier.7 is 177 lines longer than 13.2R and I've removed a few things that don't exist anymore and shortened several descriptions, but I did make /usr/local have two paragraphs instead of one. I'm still undecided about tr= ying to fill it more. Is this the correct thread to share a unified diff for feedback to people w= ho are working on maintaining hier.7? Even if it just shows you a direction na= tive users are going with it.=20 At the bottom man hier explains that it's documenting the standard install,= but a well maintained installation has a customized version. Shouldn't that mean it's desirable to describe the base system as completel= y as possible? As briefly for each piece, but as many pieces as we can? I've been filling it in for weeks. The system manual is the least bloated form of documentation available/possible. Coverage isn't adding bloat. The opposite is my humble opinion, if it doesn't have enough accessibility and coverage, then the con= cept of documentation becomes bloated with another layer, the handbook has been moved to ports and requires a pdf or webbrowser. Man is fundamental. --=20 You are receiving this mail because: You are on the CC list for the bug.=
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-261349-9-dEqolDFp1p>