OrchardCMS / OrchardCore

Orchard Core is an open-source modular and multi-tenant application framework built with ASP.NET Core, and a content management system (CMS) built on top of that framework.
https://orchardcore.net
BSD 3-Clause "New" or "Revised" License
7.35k stars 2.37k forks source link

Casing of labels, titles, buttons, etc. #1553

Open jeremycook opened 6 years ago

jeremycook commented 6 years ago

As an admin or site visitor I would like to see consistent use of casing within individual pages, across pages, and across modules. I would like to see a formal recommendation for the English language. I'm focusing on English because casing can vary between languages, and this one recommendation may be unreasonable for other languages. My thinking is that by default other languages would follow the formal English casing rule, but users of and translators to another language could choose to provide a formal recommendation when it varies from English. This topic could be expanded into a discussion of content style but for this issue and the moment I am only interested in casing.

An example of mixed casing: field labels on the Setup page are sometimes "Title Cased," and sometimes "Sentence cased."

image

Inconsistency is most commonly seen in:

sebastienros commented 6 years ago

GTG, any way you think is better. I assume "Sentence case" is more common, and works everywhere.

jeremycook commented 6 years ago

I agree that "Sentence case" is more common. I find it's easier to get right. I'd recommend it for all non-sentences including button text and page titles.

Here's a definition from Wiktionary.org that covers the basics:

The standard capitalisation of an English sentence, with the first letter uppercase and subsequent letter lowercase with exceptions such as proper nouns or acronyms. https://en.wiktionary.org/wiki/sentence_case

jeremycook commented 6 years ago

Is there interest in adding that definition or something like it somewhere in docs? It applies to so many areas (localization, module development, theme development, menu management, ...) that I'm not sure where it should go.

Piedone commented 4 months ago

Our new contrib docs could be updated with this: https://docs.orchardcore.net/en/latest/docs/guides/contributing/.