Create and edit content

We welcome your contributions, whether you are a New Relic employee or a New Relic user! And we don't want you to worry about style. When you edit a file, tech writers on our team review it for style, grammar, and formatting. That said, if you're curious about our style guidelines, you're welcome (but not obligated) to take a look.

Edit a doc

If you see a minor problem in our documentation that you want to quickly fix, you can use GitHub to edit the file and submit your pull request. A member of the Docs team will review your edit and publish your changes. We'll follow up with you if we have any questions.

To edit existing content without building the site locally:

1. On the docs site, navigate to the doc you'd like to edit.
2. Click Edit page on the top corner of the right nav.
3. A GitHub page will open with the source of the doc. Click the pencil icon in the top right.
4. Make your edits (don't worry too much about formatting or grammar, we're happy to take care of that).
5. At the bottom of the page, enter a commit message that describes your change, then click Commit changes.
6. Follow the prompts to submit your pull request.

A member of the Docs team will review your pull request and comment with any feedback. Once we've merged your pull request into the Develop branch, your changes will go live with our next deploy (usually within a few hours).

Create new docs

You can use article templates or clone an existing doc as a template. To create a new doc:

1. Clone the repo on your computer.
2. In /src/content/docs/, find a good location for your doc.
3. Using your text editor, create a new .mdx file or copy an existing doc.
4. Write your content.
5. Optional: Add your doc to the right nav .yml file. The navigation files can be a bit hard to work with, so feel free to leave this step for a Docs writer to handle when they review your pull request.
6. Commit your changes and create a pull request.

The Tech Docs team has two heroes watching for new pull requests. We'll help you get the content finalized and make sure that it's in the right place.

Clone (copy) an existing doc

Once you've cloned the docs-website repository, use your text editor to copy an existing doc. Rename and edit the copy and then save it as a new doc. Your cloned doc automatically inherits the original doc's frontmatter content. Make sure to change that, too.

If you want your cloned doc to be translated, follow standard procedures to request translation.

For bigger projects

If you're making larger changes like adding a whole new doc or editing many existing docs, it can be helpful to run the site locally. For instructions, see Tech writer workflow.

Delete pages

If you are comfortable with deleting the page yourself, go for it. If not, ask us by:

1. File an issue in the docs-website repo, or contact the @hero in the #documentation channel if you're a New Relic employee.
2. We'll take a look at your issue and help out.

Private edits

If you need to stage content for a private beta or limited release, contact the docs hero in the #documentation Slack channel.

Request a future publication date (for New Relic employees)

If your draft needs to be released on a specific date or within a specific timeframe (for example, right before a release), contact the Tech Docs @hero in the #documentation Slack channel. If you're not a New Relic employee, please create a GitHub issue.