Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
43 lines (29 sloc) 2.9 KB

Contributing Guidelines

To contribute to either the documentation or stubs, you can fork & clone our repository, make your edits, and simply push back to GitHub and send us a pull request. All items that get pulled into the main repository will automatically get pushed to our.umbraco.com/documentation.

Getting started with Git and GitHub

Repository organisation

All active work done on the documentation is currently being done on the master branch.

Keeping your UmbracoDocs fork in sync with the main repository

If you decide to clone the UmbracoDocs repository on your local machine for making larger changes that can't be done directly on GitHub then we recommend you sync with our repository before you submit your pull request. That way, you can fix any potential merge conflicts and make our lives a little bit easier.

To sync your fork with this original one, you'll have to add the upstream url, you only have to do this once:

git remote add upstream https://github.com/umbraco/UmbracoDocs.git

Then when you want to get the changes from the main repository:

git fetch upstream
git rebase upstream/master

In this command, we're syncing with the master branch, but you can, of course choose another one if needed.

Contributing documentation

All documents are written in Markdown, using a simple structure and stored as .md files. These are then pulled to our.umbraco.com/documentation for easy browsing.

First fork and clone the repository so that you have your own working copy. Then create a new branch on your local copy to make your changes. Once you are happy with your edits, use GitHub to issue a "pull request", which means your edits will be reviewed, and once accepted, merged into the main repository.

Note: It's a good idea to pull in upstream changes, merge and commit to your own fork before submitting a pull request. Instructions on how to set up a remote repo and pull from upstream can be found on this page.

Everything in the main repository will make it onto the our.umbraco.com/documentation site, which is why we have chosen a pull request workflow to keep everything simple and straightforward.

Planning & discussions

If you want to report an issue, or you planning a big change, use GitHub issues for opening a discussion. If you want to do a small change, don't hesitate to do a pull request, we don't need you to create an issue first.

You can’t perform that action at this time.