[Scummvm-devel] Capitalisation of ScummVM options
Adrian Frühwirth
scummvm-devel at bonki.net
Sun Jul 8 13:53:34 CEST 2018
Hi!
Thank you very much for doing the research and summarizing our options here, Thierry.
Since I started this discussion, here are my two cents.
> My suggestion would be to follow the Gnome HIG, which is quite similar to the Apple one , and means:
> - Title style capitalisation for push buttons or tabs.
> - Sentence style capitalisation for checkboxes, radio buttons, comboboxes labels and content.
>
> What do you think?
I agree with this and since we will have to add this information to our wiki I suggest basing our text on Microsoft's
guidelines[1] because they are easy to understand while being elaborate/strict enough to avoid ambiguity.
This means that...
Sentence-style capitalization is defined as:
* Lowercase everything except the first word and proper nouns, which include the names of brands, products and services
* Don't use internal capitalization unless it's part of a "brand" name (AdLib, FluidSynth)
* Don't use all-uppercase or all-lowercase for emphasis or as design choice
* When words are joined by a slash, capitalize the word after the slash if the word before the slash is capitalized
Title-style capitalization is defined as:
* Always capitalize the first and last words
* Don't capitalize "a", "an", or "the" unless it's the first word
* Don't capitalize "and", "but", "or", "nor", "yet", or "so" unless it's the first word or the last word
* Capitalize the second part of a hyphenated compound if it would be capitalized without the hyphen or it's the last word
I propose adapting the following rules slightly:
* Never capitalize prepositions (instead of: capitalize prepositions >four letters) unless the preposition is the first
or last word
* Never capitalize verbs unless it's the first word or the last word (instead of: capitalize all verbs)
* Capitalize all other words
-Adrian
[1] https://docs.microsoft.com/en-us/style-guide/capitalization
More information about the Scummvm-devel
mailing list