@emaste thanks for <https://github.com/freebsd/freebsd-src/commit/97beb0c9116f312c1820adb94455dc3b9a157135> – <https://github.com/freebsd/freebsd-src/blob/main/CONTRIBUTING.md> is certainly easier to digest.
A handful of minor questions/issues …
<https://github.com/freebsd/freebsd-src/blob/main/CONTRIBUTING.md#style> mentions the one-sentence-per-line rule for manual pages, however:
a) there's no such rule in mdoc(7) <https://man.freebsd.org/cgi/man.cgi?query=mdoc&sektion=7&manpath=freebsd-current> or style.mdoc(5) <https://man.freebsd.org/cgi/man.cgi?query=style.mdoc&sektion=5&manpath=freebsd-current>; and
b) I frequently see multiple lines for a single sentence – is this simply because authors and reviewers happily ignore a rule?
A random pick, from a very recently changed page:
– the longest line is 78 characters.
FreeBSD style aside, Debian man-pages(7) suggests a source code line length of no more than about 75 characters wherever possible: <https://manpages.debian.org/trixie/manpages/man-pages.7.en.html#Conventions_for_source_file_layout>.
