Gerrit/Tutorial/tl;dr

Create account

 * 1) [ https://docs.github.com/en/get-started/quickstart/set-up-git Install Git and configure your name and email address].
 * 2) [ https://docs.github.com/en/authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent Create an SSH key] (steps 1-3 are enough for Gerrit).
 * 3) Create a Wikimedia developer account.  Then, [ https://gerrit.wikimedia.org/r/login/%2Fsettings%2F%23SSHKeys log in on gerrit.wikimedia.org] and add your public key to your account.
 * 4) Also add your public key to LDAP using Special:NovaKey on wikitech.

Get the code
Clone the repository using the command in the repository browser (e.g. https://gerrit.wikimedia.org/g/mediawiki/core). You can find these on the list, or from the extension infobox on mediawiki.org. The most commonly cloned repositories are:

MediaWiki core:

MediaWiki extensions:

MediaWiki skins:

Write your patch
Now write your code. When the code is ready:
 * When working with Gerrit, do this only once per branch. To fix mistakes, use.
 * Review your patch to confirm what you are submitting to us. Press "q" to quit.
 * This pushes to Gerrit and creates a change request. If you receive an error and have previously installed the older " gerrit-tools " program, install " git-review " instead.

You are encouraged to invite one or two maintainers as reviewers on your change. After creating the change request, the  will have printed the URL for you change request. You can also find [ https://gerrit.wikimedia.org/r/dashboard/self your changes] through your Gerrit dashboard. On the change page, under " Reviewers ", click the " Add Reviewer " pencil button. Write a reviewer name in the input box. If you don't know who to invite for reviewing, check the maintainers list for the component you've modified, or ask on.

Update your patch
If a reviewer asks you to make changes, amend your commit as follows:


 * e.g. 1234 in https://gerrit.wikimedia.org/r/1234 . This downloads and checks out the change request from Gerrit.
 * Edit the source files to make your changes.
 * You can run this as many times as you like. When editing the commit message, leave the " Change-Id " line intact. }}
 * This updates your change request in Gerrit, with a new patch set version reflecting your change, and automatically notifies the subscribed reviewers.