In general, we only capitalize things when we need to. Over use of capitalization is distracting and limits accessibility for our readers with vision impairment. Read on for some guidelines on how to decide what to capitalize in a document's title, headings, products, features, and other elements of the page.
Use sentence case for headings. This includes category headings and document titles. With sentence case, capitalize only the first letter of:
- The first word
- Proper nouns
- Acronyms and abbreviations
We have some exceptions:
- If the heading is a code term, such as a variable or function, then capitalize it exactly as it's used in the code; for example:
- If the heading includes a colon, follow the Microsoft Style Guide for titles and headings, and capitalize the first word that appears after the colon; for example: APM Error profiles: Troubleshoot trends.
Use sentence case for graphical illustrations such as diagrams and figures. Explore our Screenshots and images document for more information on our image guidelines.
We use title case for products.
We don't capitalize features (including features that used to be products).
We use sentence case and bold for UI elements, even if the UI element is in a different case in the UI.
"From the Transactions page, select Transaction traces and..."
We use sentence case and bold for each element in a path that references UI pages.
Go to one.newrelic.com > APM > Transactions > Transaction traces > (select a trace) > Another thing.