Capitalization¶
Purpose¶
Capitalization is a feature of case-sensitive languages to foster relevance by drawing attention to words with capital letters. For a consistent look and feel of the software, it is important to implement capitalization consistently.
Guidelines¶
There are two types of capitalization, title capitalization and sentence style capitalization:
Title Capitalization¶
Title capitalization is when every word in a sentence, statement, phrase, or label is capitalized except for certain words. Use title capitalization primarily for titles and headers, but also for command labels. For example:
Titles and headers on windows, dialog boxes, tabs, lists, group boxes, tree views, etc.
Menu titles and menu item labels
Button labels
Don’t capitalize:
Articles: a, an, the
Coordinating conjunctions: and, but, or, for, nor, etc.
Prepositions (fewer than five letters): on, at, to, from, by, etc.
Capitalize everything else.
Sentence Style Capitalization¶
Sentence style capitalization is when the first letter of the sentence, statement, phrase, or label is capitalized and all other words are lower case. The only exception to this is proper nouns which are always capitalized.
Use sentence style capitalization for text that is or could be read as a sentence, or that is part of a sentence in conjunction with other elements. For example:
Tooltip text
Placeholder text in text fields
Checkbox labels
Labels to the left of controls in a Form Layout
Descriptions of anything
Acronyms/Initialisms, Internet¶
Words such as URL, JPEG, or LDAP should be written in capital letters
Internet (if referring to the Internet) takes a capital I.