Gerrit/New repositories

Translate this page

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.

Request new repository

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.