Date: Mon, 28 Aug 2023 20:57:21 +0000 From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 261349] Modernise hier(7) Message-ID: <bug-261349-9-Mnd2n4B0kv@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 --- 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 comple= te overview of the standard FreeBSD filesystem hierarchy, and this page is an excellent resource for learning about the system.=20 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 maintenan= ce 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 ha= ve 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 Reque= st, or to Phabricator (reviews.freebsd.org). You can tag me (@mhorne) as a revi= ewer on either site. Thanks! --=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-Mnd2n4B0kv>