Pour commencer, il vous faudra forker le dépôt principal. 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.

Khanat utilise de workflow dit “GitFlow”. De ce fait, il y a deux types de branches : principales et temporaires.

Les branches principales sont :

• Branche Lirria (aka master) : 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évellopement, dans laquelle les features terminés sont mergés, en vu des futures releases.

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

• Branche Feature : C'est une nouvelle addition au code 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 “develop”.
• Branche Release : Ce type de branche est spécifique au dépôt principal, et est crée quand toutes les feature prévu dans une nouvelle release ont été merge dans develop. Une fois cette branche créer, seul les bugfix y sont autorisés, jusqu'à ce qu'elle soit merge dans “lirria”, une fois considéré comme suffisamment stable pour la “production”.
• Branche Bugfix : C'est une branche ayant pour objectif de rapidement corriger un bug affectant Lirria. De ce fait, elle sera merge vers la branche “lirria”, ainsi que “develop”.

Les branches, que ce soit sur votre fork ou sur les dépôts officiels, doivent être nommé 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/57-69-75-nouveau-fichier-dintegration-continue”
• Branche Release : Doit être nommée “release/[futur tag]”
  • Exemple : “release/v0.2.0”
• Branche Bugfix : Doit être nommée “bugfix/[numéro du/des bug(s)]-[descriptif du/des bug(s) sans espace ni ponctuation]”
  • Exemple : “bugfix/33-empêcher-les-poisson-de-sortir-de-leau”