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 :
- le nom du compte développeur Wikimedia,
- un nom approprié pour le dépot (et donc celui de l'espace de noms parent dans Gerrit), par exemple
mediawiki/extensions/Exemple, - un projet dans Phabricator ou lire Créer un nouveau projet pour un demander un.
- 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.
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 - Extensions - règles de développement des extensions et des bibliothèques, (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.