[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