[Bug 290841] 15.0R Release Notes - inconsistent formatting and punctuation of sponsor acknowledgements

From: <bugzilla-noreply_at_freebsd.org>
Date: Tue, 18 Nov 2025 02:48:35 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=290841

--- Comment #1 from B.S. <bigsneaky@duck.com> ---
Since the document was mostly self-consistent (and consistent with the 13.0R
and 14.0R relnotes), I went ahead and made a GitHub pull request with no full
stop after sponsorship acknowledgements and only one sponsor per pair of
parentheses. 

There was a similar mish-mash of formatting for the gitrefs: some in
parentheses, some with full stop after, etc. I opted for the dominant
formatting which was also consistent with the 13.0R and (mostly) the 14.0R
relnotes. A slight difference is that 13.0R relnotes had comma-separated
gitrefs, not just space-separated like 14.0R: this seems more readable and was
the dominant form in the 15.0R relnotes anyway, so I changed the few
space-separated instances to comma-separated.

https://github.com/freebsd/freebsd-doc/pull/568

15.0R/relnotes: format gitref/sponsor consistently

Improve internal consistency based on 13.0R and 14.0R release notes.

Unless written as part of a sentence, place gitrefs
 - after end of sentence describing the change,
 - without parentheses,
 - separated by commas,
 - no full stop afterwards.

Sponsorships are formatted as "(Sponsored by Foo)" with
 - one sponsor per pair of parentheses,
 - no punctuation except as part of sponsor's name,
 - no full stop afterwards.

Comma-separated gitrefs with same sponsor only need one "Sponsored by".

Some other minor punctuation consistency, e.g. enforce serial comma.

PR: 290841

-- 
You are receiving this mail because:
You are the assignee for the bug.