This is a template. Feel free to copy the formatting tips in this template to organize the docs you create on the docs site. Then replace the template information with your own text, lists, and tables as needed.
Before you create sections, start your doc with a brief introduction, usually no more than a paragraph, that helps readers understand what your doc will cover. Your introduction (and the structure of your doc) should help readers understand within ten seconds whether they are in the right place.
Section example
Begin each section with a meaningful H2 title. The docs site uses these to generate the contents, which appears automatically in the left navigation.
If you want to include a screenshot with the section, provide a permalink for the Docs team to create the image for you. Due to security requirements, the Docs team manages all images on the docs site.
Code example
def article_url(category, article, options={})url_for(options.reverse_merge( :controller => 'articles';, :action => 'show', :category => category, :article => article))end
List example
For multi-step, actionable procedures, use ordered lists (ol
in HTML or numbers in Markdown). For example:
- Add
require('newrelic');
as the first line of your app's main module. - Use the command
npm install newrelic --save
for each application you want to monitor.
For unordered lists, use bullets (ul
in HTML or *
in Markdown). For example:
- Black
- White
For complex lists, consider using collapsers.
Table example
Tables help organize detailed lists so the information is easier to skim. Tables are easier to manage in HTML. For exammple:
<table> <thead> <tr> <th width={200}> **Item** </th>
<th> **Requirements** </th> </tr> </thead>
<tbody> <tr> <td> Some thing </td>
<td> More detailed information about it </td> </tr>
<tr> <td> Another thing </td>
<td> More detailed information about another thing </td> </tr> </tbody></table>
Tables created in Markdown use three or more hyphens ---
to create each column’s header, and pipes |
to separate each column. For example:
| Item | Requirements------------ | ------------| Some thing | More detailed information about it| Another thing | More detailed information about 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.