docs: unify title capitalization style #8973
Merged
+328
−333
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
Added our writing style guide:
Reference
Wikipedia
Capitalize the initial letter (except in rare cases, such as eBay), but otherwise follow sentence case, not title case.
https://en.wikipedia.org/wiki/Wikipedia:Manual_of_Style#Article_titles,_sections,_and_headings
Microsoft Writing Style Guide
In general, use sentence-style casing (that is, only capitalize the first word of a title, like at the beginning of a sentence), as this makes content more readable and ensures better localizability.
https://learn.microsoft.com/en-us/style-guide/text-formatting/formatting-titles
MDN
Page titles and section headings should use sentence-style capitalization (only capitalize the first word and proper nouns) rather than headline-style capitalization.
https://developer.mozilla.org/en-US/docs/MDN/Writing_guidelines/Writing_style_guide#titles
WordPress
In most cases, sentence-case capitalization is used.
https://github.com/WordPress/WordPress-Documentation-Style-Guide/blob/main/docs/3-language-grammar/capitalization.md#title-case-capitalization
Checklist