From nobody Thu Aug 03 14:08:33 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 4RGrKt4TZvz2tv2g for ; Thu, 3 Aug 2023 14:08:34 +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 4RGrKt2Mflz4G6p for ; Thu, 3 Aug 2023 14:08:34 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1691071714; 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=vBTBI2EcvwhF032YXEtJQF5Evko2HkhnRqMTN5g0214=; b=VxK6hMmuj6HzhMLTJLAo8H3edflOS6VirZ4uofJAIewusjP3UOZiq7Y9cwddH06+rZKEP6 FT4KbYz1o6C0e8Y4fEkJcHwgdj0/35JX4WekuW6FXp0JiQuEMfonxmEaTApKKhgveWEeCI e/S43VHZb725eVZH9LqkJxhI57CB6o6EV8gAmPiZgOAfM6sWwgAq6t/9oJaou8xuqCFbz9 G+4lztFts0APJyfw25TbIVGiaubwq99vyXADdu9PipFG86IYM6fHOrE2i1lPBi2irCiKMS tGT6kRRA5WWI4D8+waBlTxbc7uR+/ynls1u7F3g3do8hjXQC9is+M/ADeki58A== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1691071714; a=rsa-sha256; cv=none; b=aZfmOBb7114NLh14CON0XYbIHaVfBzQ4GkS0qUXoa/ZpgVki8hlNCDwer+snJfUfTLTxeI V0JQQ9uyyUvVDPku7gBwhehD57Rx4ylsW+zsjSoakpcsH1PJ/HU6A8JnKnZ0wgF11HtJcg X7r8nkFrnIMWESoYuLkwBusqpipKLt8Boktvz0yKVvFCAD+ZLJQy6b1NCiKkOrXJ1Lhe11 XzPcHywtRD7VImtI04FxyLDyYGL7gV8gyZ0HzAbWcb5Fr8qqFCKA4lquSzD46PHXhzZqyc rjRldnZep3/seFDGoVnoqFEU9aAL0tjQXe128jrzagGZ+z8GN9ED37u03eIvUQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none 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 4RGrKt1ShNz8Rw for ; Thu, 3 Aug 2023 14:08:34 +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 373E8YcE092497 for ; Thu, 3 Aug 2023 14:08:34 GMT (envelope-from bugzilla-noreply@freebsd.org) Received: (from bugzilla@localhost) by kenobi.freebsd.org (8.15.2/8.15.2/Submit) id 373E8YdU092496 for doc@FreeBSD.org; Thu, 3 Aug 2023 14:08:34 GMT (envelope-from bugzilla-noreply@freebsd.org) X-Authentication-Warning: kenobi.freebsd.org: bugzilla set sender to bugzilla-noreply@freebsd.org using -f From: bugzilla-noreply@freebsd.org To: doc@FreeBSD.org Subject: [Bug 270481] intro(9) needs an update/rewrite Date: Thu, 03 Aug 2023 14:08:33 +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 Only Me X-Bugzilla-Who: commit-hook@FreeBSD.org X-Bugzilla-Status: In Progress X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: mhorne@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=3D270481 --- Comment #3 from commit-hook@FreeBSD.org --- A commit in branch main references this bug: URL: https://cgit.FreeBSD.org/src/commit/?id=3D84f9f2c5cf7841fffc03ccb1833814892= ae15132 commit 84f9f2c5cf7841fffc03ccb1833814892ae15132 Author: Mitchell Horne AuthorDate: 2023-08-03 13:48:15 +0000 Commit: Mitchell Horne CommitDate: 2023-08-03 14:07:41 +0000 intro(9): rewrite from scratch This page has existed as a placeholder since its creation in 1995. It does not provide a useful introduction to the content in this section. Reimagine it as a top-level overview page containing brief descriptions and links to existing pages in section 9. It is roughly organized into sub-sections, grouped by topic or subsystem. In other words, the page is meant to function as a map to other content. There is a balance to be found here between providing as many links as possible and keeping the page concise and searchable. In general the aim is to reference pages which provide the best entry point to a particular topic. For example, a link is given to locking(9), but not to the specific lock pages such as mutex(9) or rwlock(9). NetBSD has done something similar with their intro(9), so some inspiration has been taken from there, although their content doesn't align that closely with what we have. I have done a thorough review of our existing pages and formed these subsections around them, but they are meant to evolve. PR: 270481 Reviewed by: imp, emaste MFC after: 3 weeks Relnotes: yes Sponsored by: The FreeBSD Foundation Differential Revision: https://reviews.freebsd.org/D41104 share/man/man9/intro.9 | 594 +++++++++++++++++++++++++++++++++++++++++----= ---- 1 file changed, 504 insertions(+), 90 deletions(-) --=20 You are receiving this mail because: You are on the CC list for the bug.=