Logo Khaganat
Traductions de cette page?:

Ceci est une ancienne révision du document !


Collaborer sur khanat-assets-sources

WIP

Le workflow de travail

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 : khanat-assets-sources. 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-assets-sources.

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 simplifié.Les branches principales sont :

  • Branche Master : Branche stable, qui contient toutes les données finales quiont été validées et qui ont permis de créer les assets en jeu.
  • Branche feature/XXX_nom_de_la_feature : Branche contenant des données qui répondront à l'Issue XXX, en cours de travail.

Les branches feature, que ce soit sur votre fork ou sur les dépôts officiels, doivent être nommées 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/0014_reorganize_RC_env_tex”

Organisation des dossiers et fichiers

Chaque dossier est numéroté en fonction de l'Issue à laquelle il répond, avec un nom descriptif. À l'intérieur de chacun de ces dossiers, il suffit d'avoir un répertoire /_final pour les fichiers finaux destinés au système de jeu et un autre /work pour les fichiers qui auront servi à les créer. À l'intérieur de ces deux répertoires, on peut organiser comme on veut.

Tant que le travail est en cours, accoler le suffixe _wip à son répertoire principal. Lorsque le travail est terminé, le dernier commit doit ôter ce suffixe.

Les fichiers dans le répertoire /_final doivent impérativement respecter les conventions de nommage des fichiers graphiques, et le format selon leur type.

Publication d'une feature

Une fois que vous considérez la feature que vous avez développé terminée, vous pouvez créer une Merge Request, à destination de Master. Cette requête doit respecter ces impératifs :

  • La Merge Request doit clairement expliquer en quoi elle répond à la feature

Gestion des Merge Request

Lorsqu'on a terminé une Feature, il faut faire une demande de Merge Request en expliquant en quoi la tâche est terminée et l'affecter à une autre personne même si on a la capacité de merger directement.

Cela permettra d'avoir un contrôle, ne serait-ce que formel, sur l'ajout.

On ne merge jamais soi-même directement sur Master.

Gestion des Issues

Les travaux à faire, modifications de fichier, créations, doivent être indiqués en se servant du système d'Issues de ce dépôt : Issue sur Khanat-assets-sources

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'hésitez pas à être le plus précis possible dans la zone Description.

Il y a ensuite 3 zones de champs à renseigner :

  • Assignee pour indiquer la personne à qui affecter la tâche ;
  • Milestone qui désigne la version du projet pour laquelle ce travail devra être fait ;
  • 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'indiquez rien dans ces quatre champs. De toute façon, tout est éditable a posteriori donc ce n'est pas grave si vous faites des erreurs ou n'êtes pas assez précis.

Gestion des Milestones

On se servira des mêmes milestones que pour les autres dépôts et secteurs de développement du projet, présentés sur la page milestones.

Gestion des Tags

Gestion des Labels

Les Labels doivent être génériques et concerner de préférence un type technique d'asset graphique 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.

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

Licences Mentions légales Accueil du site Contact