Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Use title case for headings #30

Open
5jt opened this issue Nov 17, 2024 · 1 comment
Open

Use title case for headings #30

5jt opened this issue Nov 17, 2024 · 1 comment

Comments

@5jt
Copy link

5jt commented Nov 17, 2024

Computing prose is full of proper names, such as Microsoft Windows. They are visually distinguished with initial majuscules. Title case hides roper names, losing information for no benefit and occasionally manufacturing an ambiguity.

interfaces to Windows
interfaces to windows

The practice seems to come from American newspapers:

Newspapers in Canada, Europe, Australia and India use sentence case.

We should use sentence case for headings.

@FionaDyalog
Copy link

I disagree. The usage of sentence case vs title case in documentation is very much a case of personal preference. There is also no US vs UK English distinction as such; the newspapers you have selected have adopted conventions, but this is not a standard for UK/US grammar.

Our documentation set has its own style guide, and all our documents use title case. This extends far beyond the ones within this project. The cost of changing them throughout the entire set is huge and I see no benefit to doing so – people who prefer sentence case will be happier, but at the expense of the people who prefer title case.

(There should also be no ambiguity in the example you show as we should always refer to "Microsoft Windows", not just "Windows" in a title.)


You can argue for either based on web searches, but the Chicago and Oxford style guides both call for title case to be used for headings.

In essence (from grammarly.com, which is not definitive but often useful):

  • Title case should be used when following MLA and Chicago style guides. Title case is more commonly seen in formal writing, such as essay titles, published books, titles of magazine articles, and other scholarly works.
  • Sentence case should be used when using AP style. It is more common in general or casual forms of writing, such as blog headlines, subject lines of emails, personal essays, and social media captions. Though sentence case is considered more informal, it is typical for newspapers to align with this style.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants