Thanks for your interest in making the osu! wiki better! This quick-start guide is intended for newcomers that have never worked with GitHub and the osu! wiki contribution workflow before. If you already have experience using GitHub, feel free to skip this guide and follow the common feature-branch workflow for content updates in this repository.
If, during any part, you are confused and/or need further help, feel free to send a message to the osu!dev Discord (
Go to the
Fork again to go to your fork.
Seeing something similar to the image below means you made a fork of
ppy/osu-wiki repo and that you are on your fork.
Go to your fork of the
Above the files, there is some text to tell you if your branch is either "behind", "ahead", or "even" with
ppy:master. If it says that the branch is either "behind" or "ahead and behind" with any amount of behind-commits, your branch is outdated.
OK (No commits and not outdated)
OK (These are your commits)
Potentially bad (Your branch is outdated)
Potentially bad (Your branch is outdated with your commits)
This isn't much of a problem; that is, if you aren't going to edit a file that was already changed which may be unlikely the more commits you are behind.
To resolve this, see the My branch is out of date! section in the Common Issues article.
When you complete step 4, continue to Editing online or locally.
At this point, you have two choices:
Note: You are not limited to the two choices listed above for editing. To keep this guide short and simple, these articles will not discuss using other tools in-depth or at all. There are other third party applications that can do more or less than what the GitHub Web Interface and GitHub Desktop already does.
When you have completed either GitHub Web Interface or GitHub Desktop, you can continue to the next section.
Go to the
If you were quick enough, you may see this yellow banner.
If you see it, click on the
Compare & pull request button (skip to step 8). If not, click the
New pull request button (continue to step 4).
On the next page, if you see these two buttons as pictured below, click the
compare across forks.
head forkdropdown and select the one with your username (it should be the second one).
comparedropdown and select the one with the branch you had created (these are listed alphabetically).
Create pull request.
Enter the title in English. This should be a very brief explanation of what you changed.
For article translations, include the two-letter language name of your translations in brackets before the title. Your title can just be the name of the article(s) that you are translating. For example,
[FR] BBCode would indicate that you are updating the French translation of the BBCode article.
Fill in the description box with a summary of your changes. You should mention any information relevant to your pull request, such as its completion status and anything you want reviewers to know. You can also make your pull request automatically close issues upon merge by writing "resolves #1" or "closes #1", etc. in the description (see Closing issues using keywords on GitHub Help).
Once you are ready, click
Create pull request.
Once you have created your pull request, other osu! wiki editors may review your changes to help catch some mistakes you may have missed. You will need to keep up with these reviews, otherwise your pull request may be marked for closure! If you want someone to review your pull request, you can ask other osu! wiki editors in the osu!dev Discord (
#osu-wiki channel) or in the GitHub comments.
For your changes to become appear live on the osu! wiki, your pull request has to be merged. Once your pull request has been reviewed and approved, you can either use the commenting section in GitHub to ask someone to merge it or do the same in the osu!dev Discord (
#osu-wiki channel). Once it is merged, your changes will take up to five hours to appear live on the osu! wiki.