Gerrit/Nouveaux dépôts
Cette page concerne la demande de création d'un nouveau dépôt de code. Tous les dépôts de code nouveau sont des dépôts Git dans Gerrit.
Si vous souhaitez être propriétaire de projet (pour pouvoir relire les corrections en tant que +2 et les fusionner) d'un dépôt de code existant dans Gerrit, voyez Règles des privilèges Gerrit.
Etape 0 : évaluation
Vous pouvez vérifier si vous êtes intéressés par Gerrit ou si vous préférez davantage GitLab (disponible depuis 2021).
Notez que GitLab permet de créer des dépôts personnels sans suivre le processus de demande formelle.
Etape 1 : obtenir un accès Git
Pour valider et faire les relectures des validations Git, nous utilisons Gerrit. Vous pouvez vous connecter à Gerrit en utilisant votre compte Wikimedia developpeur.
Chacun peut créer un compte Wikimedia développeur s'il n'existe pas déjà.
Etape 2 : demander un dépôt Git
Vous devrez avoir :
- Compte de développeur de Wikimedia
- Repository name – Décider d'un nom de référentiel approprié (et par implication, son espace de noms parent dans Gerrit), par exemple
mediawiki/extensions/Example). Vérifiez la liste des noms de référentiel existants. - Projet de Phabricateur – C'est là que les tâches concernant votre référentiel doivent être signalées, par exemple
MediaWiki-extensions-Example.
Si vous n'en avez pas encore, soumettez d'abord votre demande de projet Phabricator.
Etape 3 : valider vos fichiers
Dès que vous aurez quelques fichiers vous pourrez les valider (commit) et continuer votre travail en utilisant Git.
Etape 4: publier une page d'extension
Pour catégoriser de manière automatique et standardiser la documentation de votre extension existante, voyez Modèle:Extension. Pour ajouter votre nouvelle extension à ce wiki:
Modèles à utiliser
- {{Extension}}
- {{WikimediaDownload}}
- {{ExtensionInstall}}
- {{Git repo}}
- {{MW file}} - utilisé dans le Manuel
- ...
Etape 5: continuez le développement et profitez-en !
Vous pouvez également essayer de trouver quelques développeurs établis de MediaWiki pour revoir votre code et y déceler les points faibles, par exemple en vous addressant à la liste de diffusion wikitech-l.
Etre notifié des modifications survenues sur votre dépôt
D'autres personnes peuvent soumettre des corrections dans votre dépôt et que vous devrez aussi relire.
Il vous est possible de recevoir par courriel, les nouvelles modifications qui ont été faites sur votre dépôt. Voir Gerrit/projets suivis Si vous souhaitez être ajouté automatiquement comme relecteur à chaque nouvelle correction (ou à un sous-ensemble, à l'aide d'une expression régulière), ajoutez-vous au Robot de relecture de Gerrit.
Voir aussi
- Extensions - les lignes directrices pour le développement d'une extension ou d'une bibliothèque (Conventions de codage, architecture, licence, Sécurité, etc.)
- Git/Creating new repositories - instructions techniques pour les administrateurs Gerrit qui créent les dépôts.