[Bug 296223] Capitalization is inconsistent across pages

From: <bugzilla-noreply_at_freebsd.org>
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.