This article has not yet been verified against Umbraco 8.
The concepts and code examples might not work if you are running Umbraco 8.0 or a later version. If you are using Umbraco 7, this article is perfect for you!
You are more than welcome to report any issues found on the Documentation Issue Tracker.
Contribute to Umbraco Documentation
What is a pull request
A pull request (PR) is a way of submitting changes to a project that can then be reviewed by the Documentation Curators.
Let’s say you’ve found a typing or syntax error in one of the articles on the documentation, and you want to correct it. You can do that with a pull request.
There are two ways to create a pull request:
- You can either edit a file directly on GitHub or
- You can create a fork of the GitHub repository
It may be helpful for you to read our Markdown guidelines on how to set up Documentation articles before you start writing!
Option 1. Creating a PR directly on GitHub
GitHub has some great functionality that allows you to submit a PR directly from our repository, and there is also a button on every single documentation article at the top that links you directly to GitHub in order to edit that specific file:
This is very helpful to fix typing errors or adding small things, but if you are working on a larger update that includes pictures and editing several files in one pull request then it is not the best way to work. You'd be better creating a fork.
Options 2. Creating a PR through a fork
There are a lot of great tutorials available online on how to fork a repository (GitHub) and work with one, but we have also created a quick guide on how to do it.
If you do not have Git installed on your computer, you should also follow the instructions on how to set up Git before you go any further.
If Git is installed on your computer, follow the Create a Pull Request using a fork guide.
Creating an issue
The Umbraco Documentation uses GitHub issues to manage issues with the documentation. You can make an issue for any of the following:
- If you feel some documentation is wrong or missing and you do not have time or knowledge to do a PR.
- If the issue will need more than one PR.
- Open a discussion about possible improvements or ways to deal with something in the documentation.
You can also find a button in the top right corner of every page in the documentation itself that looks like this:
We compiled a list of labels which we use regularly to tag issues.
Annotating a document
To add version information and extra keywords, every document can be annotated using YAML.
Multi version documentation
With the introduction of every new version of Umbraco, new features are introduced. This means that not every document will work for your possibly older version.
Therefore we introduced 2 different mechanisms:
- The YAML meta data describing
- The possibility to add multiple files about the same topic
All the work of adding labels, going through issues and PR's and managing the Documentation repository is done by the Umbraco Documentation Curators team. If you wish to know more about who they are and how they work there is some information about them here: https://our.umbraco.com/community/the-documentation-curators/
If you make a pull request to any Umbraco repository that gets merged in you will get a Contributor badge on your member profile on Our:
The Documentation Curators will search for your profile when merging a PR in and add the badge. If it is forgotten just make a comment on the closed PR and we will do it as soon as possible!