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 à utiliser avec Gerrit Wikimedia :
 * 3) * Exécutez ceci à partir de votre terminal en substituant votre adresse courriel : ssh-keygen -t ed25519 -C "your_email@example.com"
 * 4) * A l'invite $prompt, vous pouvez appuyer sur Entrée et accepter les valeurs par défaut s'il s'agit de votre première clé SSH. Sinon modifiez-la pour qu'elle soit similaire à $location Otherwise, customize it to something like
 * 5) * A l'invite $prompt, choisissez une phrase secrète assez forte. Typiquement vous devrez le faire le jour où pour la première fois, vous publierez ou enverrez vos demandes de modification. 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. Ensuite, connectez-vous à gerrit.wikimedia.org et ajoutez votre clé publique à votre compte. La clé publique est le contenu de
 * 7)  to set your email address, name, and SSH username.



Obtenir le code
Recopiez le dépôt en utilisant la commande du navigateur (par exemple https://gerrit.wikimedia.org/g/mediawiki/core). Vous pouvez trouver ces dépôts dans la liste, ou à partir de la boîte d'information de l'extension sur mediawiki.org. Les dépôts le plus souvent recopiés sont :

Noyau MediaWiki :

Extensions MediaWiki :

Habillages MediaWiki :



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

Maintenant, vous pouvez éditer le code pour effectuer et tester 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 $amend. To fix mistakes, use.
 * 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.

Nous vous encourageons à inviter un ou deux mainteneurs pour la relecture de vos modifications. Après avoir créé la demande de modification, la  affichera l'URL de la demande. Vous pourrez ainsi retrouver vos modifications sur le tableau de bord de Gerrit. 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-le 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 réexécuter cela autant de fois que vous le voulez. 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.

Voir aussi

 * Efforcez-vous de suivre nos Indications concernant le message de validation.
 * Voir aussi Obtenir des commentaires