Date: Mon, 28 Aug 2023 20:57:21 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=261349 --- Comment #48 from Mitchell Horne <firstname.lastname@example.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.