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 in headings
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:
noticeError
. - 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.
Important
Use sentence case for graphical illustrations such as diagrams and figures. Explore our Screenshots and images document for more information on our image guidelines.
Products and features
Item | Example |
---|---|
We use title case for products. |
|
We don't capitalize features (including features that used to be products). |
|
UI elements and UI page paths
Item | Example |
---|---|
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. |
For more help
If you need more help, check out these support and learning resources:
- Browse the Explorers Hub to get help from the community and join in discussions.
- Find answers on our sites and learn how to use our support portal.
- Run New Relic Diagnostics, our troubleshooting tool for Linux, Windows, and macOS.
- Review New Relic's and and documentation.