Create a new version of an article
Learn how to create and add new material to the Umbraco Documentation, including updated material for upcoming releases.
Last updated
Was this helpful?
Learn how to create and add new material to the Umbraco Documentation, including updated material for upcoming releases.
Last updated
Was this helpful?
There are 2 scenarios for when you are looking to add a new article to the Umbraco Documentation.
You are to the documentation site.
This includes not-before-documented topics and new tutorials.
You are updating .
When you are adding a brand new article to the Umbraco Documentation, there are a few questions that we recommend asking yourself before getting started:
The steps to create, write, and add a brand new article to the Umbraco Documentation are outlined below:
Fork the repository.
Clone your fork to your local machine.
Create a new branch using the following naming convention: productname/topic
Branch name example: cms/new-content-app-tutorial
Locate the section/folder in the existing structure, where your article fits.
Create a new .md
file and name it identical to the title you will give the article.
The file name needs to be all small caps and use hyphens instead of spaces.
File name example: statistics-content-app-tutorial.md
.
Write the article.
Add a link to the new article in the file.
The documentation is versioned using directories in the root of the repository. The major Umbraco CMS version number is used to name the directories, and you will find documentation for each versioned Umbraco product within them.
The following sections of the Umbraco Documentation are following the versioning strategy:
Umbraco CMS
Umbraco Forms
Umbraco Deploy
Umbraco Workflow
Umbraco Commerce
Umbraco UI Builder
The documentation site for an upcoming major version of any of our products will be publicly available with the Release Candidate (RC). At Umbraco HQ we will typically start working with the site 3-4 weeks before, setting up the structure on GitHub.
Once the RC is released, you can find the associated documentation using the version drop-down on the Documentation site.
Fork the repository.
Clone your fork to your local machine.
Create a new branch using the following naming convention: productnameXX/topic
Branch name example: cms15/configuration
Locate the article you need to make changes to.
Make the necessary changes to the article.
After making the changes to the article(s), it needs to be added to the SUMMARY.md
file to be published on the documentation site.
Follow the steps below to add the article to the by looking upwards in the file structure.
Copy the line along with any ancestors.
Siblings to the current and any ancestors should be left out unless they have also been updated.
See the image below for an example of what to include.
Merge what you have copied with the existing structure in the SUMMARY.md
file for version 15.
You might experience that the article is already there. In this case you do not need to do anything further.
With the article(s) added to the SUMMARY.md
file, the final steps involve creating a Pull Request.
Add and commit the changes.
Submit the branch to your UmbracoDocs fork.
Access the repository.
Ensure the article lives up to our and follows the outlined .
Once you have completed the article, submit the branch to your UmbracoDocs fork and .
Read the article to learn more about how to handle documentation for the different versions.
Access the repository.
Locate the article in the .
.