Learn the two different ways to submit a PR to the Umbraco Documentation.
You can contribute to the Umbraco Documentation by submitting a Pull Request (PR). A PR is a way to suggest changes to an open-source project, such as fixing errors, improving readability, or adding new content.
There are two ways to create a PR:
Edit a file directly on GitHub.
Create a fork of the GitHub repository.
You need a GitHub account to create a Pull Request.
Option 1: Creating a PR directly on GitHubYou can submit a PR directly from our repository . You can also use the button on the right side of every article title. This allows you to jump straight into the file on GitHub and suggest your changes.
Following the approach is recommended for changes such as:
Fixing typos or grammar mistakes.
Changes that are confined to a single article.
Navigate to the article you want to edit.
Select "Edit on GitHub" from the right side of the article.
Select the 🖊️ icon to start editing the article.
Add a commit message describing what you changed.
Fill in the required information in the PR description.
Select Create pull request to submit the PR.
The second option to submit a PR is by using a fork of the Umbraco Documentation repository. This method requires more initial setup but lets you reuse your fork for future contributions.
Following the approach is recommended for changes such as:
Writing new articles or guides.
Adding updates that affect multiple articles.
Applying an update that needs to be added to multiple versions.
There are a lot of great tutorials available online on how to fork a repository (GitHub) .
If you do not have Git installed on your machine, follow these instructions before moving on.
Ensure Git is installed on your machine.
Select Fork in the top-right corner to create a personal copy of the repository.
Once the fork is created:
Clone your fork to your local machine.
Make your changes in a local branch.
If you add a new article, update the SUMMARY.md
file to include it in the documentation navigation.
Sync your changes back to your fork.
If you’ve had your fork for a while, sync it with the original repository before starting new changes. This process is called rebasing.
To sync via command line:
Set the original repository (UmbracoDocs) as an upstream to sync from.
git remote add upstream https://github.com/umbraco/UmbracoDocs/
git fetch upstream
git rebase upstream/main
To sync via GitHub:
Use the Sync fork option when your fork is behind the original repository.
Once you have made changes and are happy with the result, you can create a PR.
Navigate to the Code section of your fork.
Select Contribute > Open pull request.
Add a title and description explaining your changes.
Select Create pull request to submit a PR to the original repository.
Your PR will be reviewed by the documentation team at Umbraco HQ.
Review times can vary based on the size and complexity of the contribution—from a few minutes to several weeks.
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4