Gerrit/New repositories
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[edit]
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[edit]
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[edit]
You'll need the following:
- Wikimedia developer account,
- Decide on an appropiate repository name (and by implication, its parent namespace in Gerrit), e.g.
mediawiki/extensions/Example
). - Phabricator project, or see creating new project to request a new one.
Step 3: Commit your files[edit]
Once you have some files, you can commit them and continue your work utilizing Git.
Step 4: Publish an extension page[edit]
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[edit]
- {{Extension }}
- {{WikimediaDownload }}
- {{ExtensionInstall }}
- {{Gitweb }}
- {{MW file }} - used in the Manual
- ...
Step 5: Continue development and enjoy![edit]
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[edit]
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[edit]
- 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