Capitalization
Avoid unnecessary capitalization. Too much capitalization is distracting because it's hard for the reader to understand whether they have missed some information. Make sure the context is clear so that the user can understand whether you are referring to a generic or Unity-specific understanding of the term.
note
Historically, the Unity documentation capitalizes many terms that relate to Unity features. Don't rely on existing documentation to determine whether a term requires capitalization. If in doubt, check with the style guide team. Fix incorrectly capitalized terms as you find them in your documentation.
Nouns
Only capitalize the following types of noun phrases:
- Product names, including Unity and non-Unity apps and services, packages, and tools.
- UI windows and views.
- Components and properties.
- Some features, concepts, and terms that relate to specific Unity products. Instances that require capitalization are rare and are described in the Terminology list. If your term doesn't appear in the Terminology list, check with the style guide team to determine whether it requires capitalization.
If a product name is a phrase that can be used generically, only use capitals when you are specifically referring to the product. Don’t use capitals when you use the phrase generically.
Don’t capitalize names of generic features or concepts inside Unity products unless you are specifically referring to UI elements that use their names.
Incorrect | Correct |
---|---|
Every GameObject has a transform component, which determines its Position, Rotation, and Scale. | Every GameObject has a Transform component, which determines its position, rotation, and scale. The values are stored in Transform component properties named Position, Rotation, and Scale, respectively |
API and programming terms
Don’t capitalize the names of generic programming concepts. For example, jobs, tasks, coroutines, and networking.
Write the names of API members with the exact capitalization that the user must type. Use monospaced font (including in links) for all references to API members.
Capitalization for emphasis
Never capitalize words for emphasis.
Incorrect | Correct |
---|---|
Unity does NOT update or re-publish legacy documentation. | Unity doesn't update or re-publish legacy documentation. |
A GameObject ALWAYS has a Transform component attached. | A GameObject always has a Transform component attached. |
Make sure scripts that reference the Animator search for the animator in the CHILD GameObject, instead of the root. | Make sure scripts that reference the Animator search for the animator in the child GameObject, instead of the root. |
Initialisms and acronyms
When you spell out an initialism or acronym, don’t capitalize the letters that make up the abbreviation, unless the abbreviation is a proper noun or contains proper nouns.
For more information and examples, check Initialisms and acronyms.
Titles and headings
Use sentence case in titles. For more details on formatting titles, check Titles and headings.
Job titles
Capitalize a job title only when it precedes a person's name, or is used to address a specific person. In these cases, the title is part of a proper noun.
Use all lowercase when the title follows a name, or is used to describe a job position but not a specific person.
Incorrect | Correct |
---|---|
Please welcome chief executive officer John Smith. | Please welcome Chief Executive Officer John Smith. |
Thank you for this honor, governor. | Thank you for this honor, Governor. |
Jane Smith, Senior Program Manager, will lead the meeting. | Jane Smith, senior program manager, will lead the meeting. |
You can develop the skills to be a Technical Artist. | You can develop the skills to be a technical artist. |
Link text
In link text, use the same capitalization as the name of the link target. For more details on writing link text, check Links and citations.