Adding a New Article

How to add a new article to the Documentation Hub.

Thanks for your interest in submitting documentation articles! This article shows you how to add a new article to the TrueNAS Documentation Hub. All that is required is a GitHub account and your favorite text editor. Taking screenshots for your article is also recommended.

To add an article, construct a bundle that contains your text file and any images, then open a pull request on the repository. There is an Article Template available that can simplify creating your article.

Creating an Article Bundle

Find a place on your local system to create a directory for your article. Name the directory according to the title of your article.



Open the directory and create a new file called index.md. This file will contain all the text for your article.

Writing the Article

The first few lines of the index.md are reserved for an intro block called the “front matter” that contains the document title and other information. For example, this article uses basic front matter:

---
title: "Adding a New Article"
linkTitle: "New Articles"
description: "How to add a new article to the Documentation Hub."
weight: 2
---

After setting the front matter, continue writing your article. Raw text is supported, or you can add Markdown syntax. Markdown is designed to be easy to write and read, but also supports directly adding HTML elements. See the Style Guide for syntax help and other suggestions for writing the article. You can generally style the article however you like, but please be aware that other contributors might review the article and change the styling.

Adding Images

If you want to include screenshots of the TrueNAS User Interface with your article, add these files to your article bundle. Be sure to have unique names for each image file.



Uploading the Article Bundle

Open the Community Docs section of the repository at https://github.com/freenas/documentation/tree/master/content/en/hub/additional-topics/community. When submitting an article in a language other than English, change the /en/ to the language directory that matches the language of your article.

Community Articles

Click Upload files and drag and drop the article bundle directory into the repository. GitHub shows all the files that will be uploaded.

Uploading an Article Bundle

Opening a Pull Request

Make sure all your files have been uploaded then scroll down to the Commit changes section and write a summary and description of your changes. Select Create a new branch for this commit and start a pull request. and click Propose changes. GitHub can take a few moments to process the files.

Make sure you’re happy with the summary and description of your article, then click Create pull request.

After the pull request is created, the repository automatically builds a preview of the documentation site that has your changes included. The link to this preview is added to the Pull Request after the build completes.

New Article Preview

Other contributors will review and merge your article!