Logo Khaganat
Traductions de cette page?:

Ceci est une ancienne révision du document !


Collaborer sur le dépôt khanat-ressources

WIP

Avoir un dépôt sur lequel travailler

Mise en place d'un dépôt personnel (fork)

Pour commencer, il vous faudra forker le dépôt principal : https://git.khaganat.net/khaganat/khanat-ressources. Ainsi, vous aurez votre propre dépôt, sur lequel vous pourrez effectuer vos modification sans interférer avec le dépôt principal.

Pour cela, il vous suffit de clique sur le bouton suivant sur la page d’accueil du projet.

Vous serrez alors redirigé vers votre copie du dépôt.

Travailler directement sur le dépôt principal

Si vous êtes un développeur “officiel” chez nous, vous aurez accès au dépôt principal sur notre GitLab : khanat-ressources.

Vous n'aurez pas à créer un dépôt personnel (sauf si vous en avez envie) pour pouvoir contribuer, il vous suffira de travailler sur des branches en interne.

Le dépôt et ses branches

Khanat utilise un workflow inspiré de Gitflow. De ce fait, il y a deux types de branches : principales et temporaires.

Les branches principales sont :

  • Branche Master (aka Lirria) : Branche stable, où seul les hotfix et les nouvelles release sont autorisés à être mergés. Cette branche garantie une expérience sans (trop de) bugs, dans la mesure du possible.
  • Branche Develop : Branche de dévelopement, dans laquelle les features terminés sont mergés, en vu des futures releases.
  • Branche Spofu : Branche de test, qui permet de tester sur le serveur spofu de nouvelles données.

A cela s'ajoute des branches temporaires, ouvertes et fermés suivants les besoins:

  • Branche Feature : C'est une nouvelle addition au contenu de Khanat, développée dans une branche séparé afin de réduire les risque d'introduction de bugs dans develop. Elle sera à merge sur la branche “spofu” pour tester ou, si cela n'est pas nécessaire, sur “lirria”.

Les branches, que ce soit sur votre fork ou sur les dépôts officiels, doivent être nommés de la façon suivante:

  • Branche Feature : Doit être nommée “feature/[numéro(s) de(s) (l')issue][nom de la feature sans espaces ni ponctuation]”
    • Exemple : “feature/43-mission_peche”

Publication d'une feature

Une fois que vous considérez la feature que vous avez développé terminée (après des tests éventuels sur spofu), vous pouvez créer une Merge Request, à destination de lirria. Cette requête doit respecter ces impératifs :

  • La feature et son code doivent être documentée.
  • La Merge Request doit clairement expliquer la feature (son utilisation et de la doc éventuelle etc.)

Gestion des Merge Request

Gestion des Issues

Gestion des Milestones

Gestion des Tags

Gestion des Labels

CC Attribution-Share Alike 4.0 International Driven by DokuWiki
fr/collabo_khanat-ressources.1479248117.txt.gz · Dernière modification : 2021/12/03 19:18 (modification externe)

Licences Mentions légales Accueil du site Contact