From nobody Mon Aug 28 20:57:21 2023 X-Original-To: doc@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 4RZND243Lnz4rxbQ 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 4RZND232ybz4KjB 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=fW2kz7W1vv8GLFXz0R+IhEV8sQlJfc+jGo5z+j+Oso7q1q8G0/vJgnkVUtgAEe8IMEh1CN wZexPDoigzSbA4dQACNs96kV99Dkv3H1Fxmz6PePfUXeYqcvFUEqgysIHdXnXMeFXl1c// yHdsSxCZhdQ0yEUk8fHMsD2p8wjVLYX7npdVQQFh+bsc3BI5W/R0HNqXLu88SeL+15oTRA 8z4oakZ4VG4Ogd6JtW5/sQT2GHZ9QNkroxcmk+DM0VyxnLGrR1gcnV7zYSq9K/D+gBaP9R guJOjY+/+TRIwbrZzDl0YdggMgKbpIgZdfvnUTJmVG8MaJDKEPK+sK/CapfNhQ== 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=KJBH0apep698t++Fu6ZZfdtmDZpXL0E/oil1eT54uV4=; b=EfIW/cV6AMiaWWue7PM1IdDPXVdRnkU5L9m5d02ghw27Ormi1VHbKt9rcj8ljzb0uIrpaP yB2jAnQ1eLC97hWe3E4LwvEK0ZS11xwfk45OMPTIRi/usic/6yLGsimo5zQ5LqSIPr28g4 YkLawX24Z4E53BhKfhWHDTWyiE72HteRNPX6z7EuLmslFM9ct0ndlUiBvYZL9ls4NxgLGv c3DjD8g1Hvvva7QConrZ5YyGS+9WH+MZDJ+fceBfjNsArchAEXOYMYFgN5JuvNOFznpM7t MUBNMrzcMqqnMsJllDUaUXV1ztMn/dzj2ciMxk6X36p/mxrxIPxPKjaWbpwmjA== 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 4RZND227QVz8VY 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 37SKvMpw007100 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 37SKvMgZ007098 for doc@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: doc@FreeBSD.org Subject: [Bug 261349] Modernise hier(7) Date: Mon, 28 Aug 2023 20:57:21 +0000 X-Bugzilla-Reason: CC 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: Documentation project List-Archive: https://lists.freebsd.org/archives/freebsd-doc List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-freebsd-doc@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 on the CC list for the bug.=