Gerrit/New repositories/dtp
This page is about requesting the creation of a new code repository. All new code repositories are Git repositories in Gerrit .
If you want to be a project owner (to be able to review a patch as +2 and merge it) of an existing code repository in Gerrit, see Gerrit/Privilege policy .
Step 0: Evaluation
You may check if you are interested in Gerrit or if you may prefer GitLab (available since 2021).
Note that GitLab allows to create personal repositories without a formal request process.
Step 1: Get Git access
To commit and review Git commits, we use Gerrit. You can login to Gerrit using your Wikimedia developer account.
Anybody can create a Wikimedia developer account if you don't have one yet.
Step 2: Request a Git repository
You'll need the following:
- Wikimedia developer account
- Repository name – Decide on an appropriate repository name (and by implication, its parent namespace in Gerrit), e.g.
mediawiki/extensions/Example
). Check the list of existing repository names.
- Phabricator project
– This is where tasks about your repository should be reported, e.g. MediaWiki-extensions-Example
.
If you don't have one yet, then submit your request for a Phabricator project first.
Step 3: Commit your files
Once you have some files, you can commit them and continue your work utilizing Git.
Step 4: Publish an extension page
To autocategorize and standardize the documentation of your existing extension, please see Template:Extension . To add your new extension to this wiki:
Templates to use
- {{Extension }}
- {{WikimediaDownload }}
- {{ExtensionInstall }}
- {{Git repo }}
- {{MW file }} - used in the Manual
- ...
Step 5: Continue development and enjoy!
You could also try to find a couple of established MediaWiki developers to look over your code and point out any flaws in it, for example by asking on the wikitech-l mailing list.
Getting notified of changes in your repository
Other people may submit patches to your repository which you should review.
You can have new changes in your repository emailed to you by Gerrit. See Gerrit/watched projects . If you want to be automatically added as a reviewer to each new patchset (or a subset by regex), add yourself to the Gerrit reviewer bot.
See also
- Manual:Extensions - extension or library development guidelines (coding conventions, architecture, license, security, etc.)
- Git/Creating new repositories - Technical instructions for Gerrit administrators who create repositories