From nobody Mon Aug 28 20:57:21 2023 X-Original-To: bugs@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4RZND24s33z4rxbR for ; Mon, 28 Aug 2023 20:57:22 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4RZND23j0Fz4KWl for ; Mon, 28 Aug 2023 20:57:22 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1693256242; a=rsa-sha256; cv=none; b=eQ/DLQfSEe10YGoS6VRqv7F4Jv9kSWQdMjHae3y91EOAnam4ff9UfY5RlGTgKkG32wm2N+ iIdZdTDzLIsayXQWAdLajPtQQVpKLbdT+X6x+C/MZPKAmEb5WZjSXy1l0KprVqslI82/sb a/zjyZJELgSCcM/x57UX1OlFCnaIdGKwpoLbafvrXOAYKhmR3GYAbAlf2ScgvXqPxsdmuS aLvcHInKEWfMFyvv7Enx6hsCMzKVp1B9p4fGMI1f3bx7iVs9ATNpL2lF212CWOi/OKFgYk e9soCde0Ph5cR4jllVVlear3610Az75rfKGob1Blv3+XVNqHOsTQKQIwC9qimQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1693256242; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=gV62vCS/31kE4J/trz/5E1+53W9ijoENt8KToNQyTek=; b=CDKWMEg7xe1B7HRv9FsYm/dXwb8AIAGRmS2Cuj1Vl97t2haF15FMob65w1DuASFXO3hGSj /G+LuOxxOJvzQo1zI4ZqTabfYDAK/0ghYkAwZiH0oZlt/mos5NX6WKOeTN84OBJeDvhkgg /LSZw3yamZ6mccUbLGyeP+xzbIkxgpIH/HC66udDKnkVoe93HWFNqBVmodcuIVZqxBcSZX WrpfDSH3PjdASydV+GDa3BbInFoaY35DZYnptLUw0ztT7EaoIPrVgal6kaOWl/JRMpk2+v 0O4vUlnBpCGOPMJcniMwDakt7l+qRtOVe6BJC6eAjsYFRtudBSpOfOXBxshXHw== Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2610:1c1:1:606c::50:1d]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4RZND22lc0z8VZ for ; Mon, 28 Aug 2023 20:57:22 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org ([127.0.1.5]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id 37SKvMUw007107 for ; Mon, 28 Aug 2023 20:57:22 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from www@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 37SKvMJX007106 for bugs@FreeBSD.org; Mon, 28 Aug 2023 20:57:22 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: www set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: bugs@FreeBSD.org Subject: [Bug 261349] Modernise hier(7) Date: Mon, 28 Aug 2023 20:57:21 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: changed X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Manual Pages X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Some People X-Bugzilla-Who: mhorne@freebsd.org X-Bugzilla-Status: Open X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: bugs@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: Message-ID: In-Reply-To: References: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated List-Id: Bug reports List-Archive: https://lists.freebsd.org/archives/freebsd-bugs List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-bugs@freebsd.org MIME-Version: 1.0 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D261349 --- Comment #48 from Mitchell Horne --- (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 the assignee for the bug.=