[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:40:11 UTC
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=296223
--- Comment #2 from commit-hook@FreeBSD.org ---
A commit in branch main references this bug:
URL:
https://cgit.FreeBSD.org/doc/commit/?id=8fad59f91dde7b4148ad5d5b00f74d8827bc8620
commit 8fad59f91dde7b4148ad5d5b00f74d8827bc8620
Author: Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2026-11-15 10:38:47 +0000
Commit: Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-11-15 10:38:51 +0000
FDP/writing style: Headings are in title case
In the FreeBSD documentation project, headings are title case following
older American publishing tradition. Google and Microsoft style guides
have switched to sentence case, but I for one like our old world style
and the quality it usually implies, and want to carry that torch.
There are different style houses have subtle nuances on what constitutes
a "small word", and I do not think there is anything to be gained from
doing a whole bikeshed on which one to follow and then trying to get all
the docs to use that consistently. For now, fix this consistently on the
writing style page without adding a new rule.
PR: 296223
Reviewed by: carlavilla
Differential Revision: https://reviews.freebsd.org/D61592
.../content/en/books/fdp-primer/writing-style/_index.adoc | 9 ++++-----
1 file changed, 4 insertions(+), 5 deletions(-)
--
You are receiving this mail because:
You are the assignee for the bug.