Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente | ||
fr:collabo_pymanager [2017/12/09 21:28] – YannK | fr:collabo_pymanager [2021/12/03 19:19] (Version actuelle) – modification externe 127.0.0.1 | ||
---|---|---|---|
Ligne 5: | Ligne 5: | ||
Ce dépôt est celui qui contient tout les librairies et utilitaires python mis en place pour gérer tous les objets des services et clients d' | Ce dépôt est celui qui contient tout les librairies et utilitaires python mis en place pour gérer tous les objets des services et clients d' | ||
- | <WRAP center round important 60%> | + | |
- | Page en cours de création | + | ===== Le workflow de travail ===== |
- | </WRAP> | + | |
+ | ==== Mise en place d'un dépôt personnel (fork) ==== | ||
+ | |||
+ | 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. | ||
+ | |||
+ | |||
+ | ==== Travailler directement sur le dépôt principal ==== | ||
+ | |||
+ | Si vous êtes un développeur " | ||
+ | |||
+ | Vous n' | ||
+ | |||
+ | ==== Le dépôt et ses branches ==== | ||
+ | |||
+ | Khanat utilise un workflow inspiré de [[fr: | ||
+ | |||
+ | 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évellopement, | ||
+ | |||
+ | |||
+ | A cela s' | ||
+ | |||
+ | * 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' | ||
+ | * Branche **Release** : Ce type de branche est **spécifique au dépôt principal**, | ||
+ | * Branche **Hotfix** : C'est une branche ayant pour objectif de **rapidement corriger un bug critique affectant Lirria**. De ce fait, elle sera merge vers la branche " | ||
+ | |||
+ | 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 " | ||
+ | * Exemple : " | ||
+ | * Branche **Release** : Doit être nommée " | ||
+ | * Exemple : " | ||
+ | * Branche **Hotfix** : Doit être nommée " | ||
+ | * Exemple : " | ||
+ | |||
+ | ==== Publication d'une feature ==== | ||
+ | |||
+ | Une fois que vous considérez la feature que vous avez développé terminé, vous pouvez créer une Merge Request, à destination de **Develop**. Cette requête doit respecter ces impératifs : | ||
+ | |||
+ | * La feature et son code doivent être documentés ; | ||
+ | * La Merge Request doit clairement expliquer la feature (son utilisation, | ||
+ | |||
+ | ==== Publication d'une release ==== | ||
+ | |||
+ | Une fois un certain nombre de features sont mergés avec Develop, nous créons une nouvelle branche release. A partir de ce moment, seul les bugfix sont acceptés (code freeze). | ||
+ | |||
+ | Une fois le nouveau code testé, et les bugs corrigés, la release est tagué, et publié dans master. | ||
+ | |||
+ | ==== Créer un HotFix ==== | ||
+ | |||
+ | Il arrive que des bugs critiques passe à travers les maillons du filet de la QA, c'est pourquoi il est parfois nécessaire de faire des " | ||
+ | |||
+ | Pour cela, il faut faire une branche " | ||
+ | |||
+ | ===== Gestion des Merge Request ===== | ||
+ | |||
+ | Lorsqu' | ||
+ | |||
+ | Cela permettra d' | ||
+ | |||
+ | **On ne merge jamais soi-même directement sur Master**. | ||
+ | |||
+ | ===== Gestion des Issues ===== | ||
+ | |||
+ | De préférence à la [[taf>fr:start|la base TAF]], créez les demandes d' | ||
+ | |||
+ | De même, avant de commencer une tâche, créez une Issue que vous vous attribuez, comme ça vous pouvez numéroter la branche correctement et on sait que quelqu' | ||
+ | |||
+ | Les travaux à faire, modifications de fichier, créations, doivent être indiqués en se servant du système d'// | ||
+ | |||
+ | Il suffit de cliquer sur : {{ : | ||
+ | |||
+ | Vous renseignez ensuite les différents champs. | ||
+ | |||
+ | Le titre doit être concis et le plus explicite possible. | ||
+ | \\ Par contre, n' | ||
+ | |||
+ | Il y a ensuite 3 zones de champs à renseigner : | ||
+ | |||
+ | * // | ||
+ | * // | ||
+ | * //Labels// permet de choisir des tags pour déterminer le genre de tâche ; | ||
+ | * //Select due date// propose de fixer une date de remise des travaux. | ||
+ | |||
+ | Dans le doute, n' | ||
+ | ===== Gestion des Milestones ===== | ||
+ | |||
+ | On se servira des mêmes // | ||
+ | |||
+ | ===== Gestion des Tags ===== | ||
+ | |||
+ | Nous n' | ||
+ | ===== Gestion des Labels ===== | ||
+ | |||
+ | Les //Labels// doivent être génériques et permettre ainsi de regrouper par genre de compétence. Il est possible d'en créer lors de la génération d'une //Issue// si aucune ne convient mais cela peut être fait par la suite, surtout quand on est indécis. | ||
{{tag> | {{tag> |