[Bug 261349] Modernise hier(7)

From: <bugzilla-noreply_at_freebsd.org>
Date: Wed, 16 Aug 2023 07:35:50 UTC

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 says
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 trying
to fill it more.

Is this the correct thread to share a unified diff for feedback to people who
are working on maintaining hier.7? Even if it just shows you a direction native
users are going with it. 

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 completely 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 concept
of documentation becomes bloated with another layer, the handbook has been
moved to ports and requires a pdf or webbrowser. Man is fundamental.

You are receiving this mail because:
You are on the CC list for the bug.