Date: Thu, 03 Aug 2023 14:08:33 +0000 From: bugzilla-noreply@freebsd.org To: arch@FreeBSD.org Subject: [Bug 270481] intro(9) needs an update/rewrite Message-ID: <bug-270481-24229-a2wmcY4uCc@https.bugs.freebsd.org/bugzilla/> In-Reply-To: <bug-270481-24229@https.bugs.freebsd.org/bugzilla/> References: <bug-270481-24229@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=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 <mhorne@FreeBSD.org> AuthorDate: 2023-08-03 13:48:15 +0000 Commit: Mitchell Horne <mhorne@FreeBSD.org> 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.=
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-270481-24229-a2wmcY4uCc>