[Bug 261349] Modernise hier(7)

From: <bugzilla-noreply_at_freebsd.org>
Date: Mon, 28 Aug 2023 20:57:21 UTC

--- Comment #48 from Mitchell Horne <mhorne@freebsd.org> ---
(In reply to Alexander Ziaee from comment #43)

Hi Alexander,

Thanks for your work and interest in hier(7) improvements. This is the right
place to enter the discussion.

You seem to be asking why we have removed some portions of the document. You
can read the justification for each of the individual changes linked by 'See
Also' above.

In general I agree that the goal of the hier(7) page is to provide a complete
overview of the standard FreeBSD filesystem hierarchy, and this page is an
excellent resource for learning about the system. 

However, it is important that we aim for 'useful completeness' rather than 100%
completeness. The reason is that every entry in this page adds to the
maintenance burden. The existence of this PR is evidence that the maintenance
burden of this page is bigger than the ability of the community to maintain it.
So, to address the root of the problem, some of the updates to this page have
removed information that was partially outdated and considered to be of
secondary interest to most users; the best example is the contents of /usr/src.

I will gladly review further contributions you have to hier(7). The rendered
output is helpful to read, but to see what has been modified we also need a
diff. To ease the review process, please submit this as a GitHub Pull Request,
or to Phabricator (reviews.freebsd.org). You can tag me (@mhorne) as a reviewer
on either site. Thanks!

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