[Bug 296223] Capitalization is inconsistent across pages
- In reply to: bugzilla-noreply_a_freebsd.org: "[Bug 296223] Capitalization is inconsistent across pages"
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Sun, 15 Nov 2026 10:01:35 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=296223
Alexander Ziaee <ziaee@FreeBSD.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
CC| |ziaee@FreeBSD.org
Status|New |Open
--- Comment #1 from Alexander Ziaee <ziaee@FreeBSD.org> ---
Thanks for sending this in. I will fix the inconsistency in the FDP headings.
Note that the documentation project does use title case for headings the vast
majority of the time, and we have commits in the tree over the decades fixing
the drift that accumulates, but it's been a while since someone's done it.
Title case headings aligns with all of the traditional American style houses.
Google and Microsoft style guides use sentence case, which is certainly where
people get the instinct to use sentence case, but the documentation project
uses lots of old school style elements, and I think it's fair to say that we as
a community prefer that across the board.
If we're going to do an explicit rule, it belongs in FDP/writing style, however
I suspect we did not do that in the past because there are subtle nuances in
how the different style houses define a "small word", and it would be a lot to
go over them with a fine toothed comb.
--
You are receiving this mail because:
You are the assignee for the bug.