GitLab Issues - Projet de Développement Apprentissage BUT3

Ce guide est adapté à la version de GitLab utilisée à l’IUT d’Orsay.

Milestone (Sprint)¶

Allez dans Plan > Milestones.
Cliquez sur New milestone.
Remplissez les champs de la façon suivante.

Enregistrez le milestone.

Issues¶

Allez dans Plan > Issues.
Cliquez sur New issue.
Remplissez les champs de la manière suivante.

Description

Ajoutez ici des explications et détails techniques. Les images peuvent être ajoutées plus tard avec le bouton `Add design` que vous allez voir dans la suite.

## Critères d'acceptation
<Liste de critères ou d'autres issues>

Il y a deux types de liste de critères que vous pouvez utiliser.
La première est une checklist :

- [ ] Critère 1
- [ ] Critère 2
- [ ] Critère 3

L’issue sera considérée comme fermée si tous les critères sont remplis/cochés. Un issue doit être assez petit, de telle sorte qu’il n’y ait pas plus de 3 critères.

La deuxième est une liste d’autres issues :

#<numéro de l’issue> <nom de l’issue>
...

Par exemple:

 - #45 Ajout des arbres dans le premier niveau.
 - #60 Ajout de l'eau dans le deuxième niveau.
 - ...

Vous pouvez ainsi créer des “grosses” issues que vous pouvez découper en plusieurs petites issues par la suite (et donc la description pourrait être remplie après).

Labels¶

Ajoutez des labels suivants pour organiser vos issues. Vous êtes libre sur les choix des couleurs.

D’autres labels

Pour chaque type de label, vous pouvez en ajouter d’autres selon vos besoins.

Weights¶

Un poids représente la complexité de l’issue. Vous pouvez le système suivant :

1 à 5 pour les issues simples à complexes.
6 ou plus pour issue parent (somme des poids des issues enfants), souvent venant du product backlog.

Donnez un poids à votre issue.

Autres paramètres¶

Quand un sprint commence, vous pouvez changer la milestone de l’issue pour la mettre dans le sprint en cours et aussi Assignees pour diviser le travail dans le groupe. Faites attention à ce qu’il n’y ait pas une trop grande différence de poids entre chaque membre.

Vous pouvez ajouter des dates pour fixer les deadlines pour chaque membre mais c’est optionnel car les issues sont déjà dans les sprints qui sont datés.

Les autres paramètres ne seront pas utilisées.

Interface d’une issue¶

Une fois une issue créée, cliquez dessus.

Add design

Vous pouvez ajouter une ou plusieurs images si nécessaire pour enrichir la description de l’issue. Par exemple, une maquette pour un menu.

Child items et Linked items

Une fois plusieurs issues crées, vous pouvez les lier entre elles.

Child items ne fonctionnent pas bien avec notre version de GitLab. Nos liens de parenté entre les issues sont directement dans la description.

Linked items est optionnel et les liens les plus utiles pour nous sont blocks et is blocked by pour indiquer les dépendances entre les issues. Souvent, nous cherchons à ne pas avoir trop de liens bloquant par Sprint pour éviter d’avoir des développeurs qui attendent des autres. Ces liens sont purement informatifs et ne bloquent pas les merges/commits.

Close et Reopen Issue

Depuis l’interface d’une issue sur GitLab, vous pouvez cocher les critères pour indiquer les parties du développement qui sont terminées. Une fois tous les critères sont cochés, vous pouvez fermer manuellement l’issue en cliquant sur Close issue.

Une issue fermée par erreur peut être réouverte en cliquant sur Reopen issue.

Bulk edit

Dans Plan > Issues, cliquez sur Bulk edit pour modifier plusieurs issues en une seule fois. Par exemple, en fin de sprint, les issues en cours de développement pourront être basculées vers le sprint/milestone suivant.

Issue boards¶

Allez dans Plan > Issue boards.
Créez une nouvelle issue board pour chaque Sprint.

Dans chaque tableau de sprint, nous allons avoir les listes suivantes :

Open qui correspond au Product Backlog
status::todo pour les issues à faire pour le sprint courant.
status::in-progress pour les issues en cours de développement.
status::in-review pour les issues en cours de test/validation (souvent par un autre membre).
Closed pour les issues fermées.

Ajoutez les différentes listes à votre issue board.

Drag and drop

Vous pouvez déplacer les issues entre les listes et les labels seront automatiquement mis à jour. Une issue peut aussi être fermée de cette façon.

Vous pouvez aussi créer une issue à partir de cette interface.