Gerrit/Tutorial/tl;dr/fr

Prérequis

 * 1) Installer Git et configurer votre nom et votre adresse courriel.
 * 2) Créer une nouvelle clé SSH key à utiliser avec Gerrit pour Wikimedia :
 * 3) * Exécutez ceci à partir de votre terminal en substituant votre adresse courriel : ssh-keygen -t ed25519 -C "your_email@example.com"
 * 4) * At the " " prompt, you can press Enter to accept the default if this is your first SSH key. Otherwise, customize it to something like
 * 5) * At the " " prompt, choose a strong passphrase. You will typically have to the first time on a given day when pulling or sending change requests.
 * 6) Créer un compte développeur Wikimedia. Puis Connectez-vous à gerrit.wikimedia.org et ajoutez votre clé publique à votre compte. La clé publique est le contenu de



Obtenir le 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:

Pour le noyau MediaWiki :

Ou, pour une extension :

Ou, pour un habillage :



Ecrire votre correction
Commencez votre branche à partir du master le plus récent :

Maintenant, corrigez le code et testez vos modifications. Dès que vous êtes satisfait et que le code est prêt et opérationnel :
 * Dans le monde Gerrit vous ne devez faire cela qu'une fois par branche. Pour corriger les erreurs, utiliser.
 * Relisez votre correction pour confirmer ce que vous nous soumettez. Pressez « q » pour quitter.
 * Ceci propulse votre code sur Gerrit et crée une demande de modification. Si vous obtenez des erreurs et que vous avez installé précédemment l'ancien programme gerrit-tools, installez git-review en remplacement.

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 your changes through your Gerrit dashboard. Sur la page des modifications, sous « Reviewers », cliquez sur le bouton du crayon « Add Reviewer ». Entrez le nom d'un relecteur dans la boîte de saisie. Si vous ne connaissez pas de relecteur à inviter, ouvrez la liste des mainteneurs pour le composant que vous avez modifié, ou demandez sur.



Mettre à jour vos corrections
Si le mainteneur vous demande de faire une correction, amendez votre validation ainsi :


 * par exemple 1234 dans https://gerrit.wikimedia.org/r/1234. Ceci télécharge et recopie la demande de modification à partir de Gerrit.
 * Editez les fichiers source pour appliquer vos modifications.
 * Vous pouvez faire cela plusieurs fois. Lorsque vous modifiez le message de validation, laissez la ligne « Change-Id » intacte.
 * Ceci met à jour votre demande de modification dans Gerrit avec une nouvelle version de l'ensemble des patchs reflètant vos corrections, et envoie une demande de relecture du code aux relecteurs qui sont abonnés.