Organiser le dépôt GitLab
Un dépôt commun pour le jeu et les documents partagés ; un README pour s’y retrouver.
Pour commencer¶
Créez sur le GitLab de l’IUT un projet nommé
projet-s501-2026-2027-<nom-equipe>, avec un nom d’équipe en minuscules,
sans espaces ni accents. Donnez accès à tous les membres et aux deux encadrants.
Commencez par le README, le projet Godot et le document de design. Les autres documents sont créés au fil du calendrier : aucun dossier vide ni document rempli à l’avance n’est demandé.
Où ranger les fichiers ?¶
Les chemins suivants partent de la racine du dépôt de l’équipe.
| Emplacement | Contenu et consignes |
|---|---|
README.md | Présentation de l’équipe, lancement du jeu et liens utiles. |
Dossier du jeu, par exemple godot4/ | project.godot, scènes, scripts et ressources nécessaires. |
docs/design.md | Document de design. |
docs/repartition-rendus.md | Répartition des quinze écrits. |
docs/product-backlog-initial.md | Synthèse du Product Backlog initial. |
docs/sprint-N-initial.md | Plans initiaux des Sprints 1 à 4. |
docs/reunions/AAAA-MM-JJ.md | Notes de réunion, datées du jour de la séance. |
docs/reviews/sprint-N.md | Sprint Reviews 1, 2 et 4. |
docs/tests/rapport.md | Rapport de tests du Sprint 3. |
docs/presentations/livrable-N.pdf | Supports des livrables 0 à 4, identiques aux PDF remis sur Moodle. |
docs/presentations/soutenance-finale.pdf | Support de la soutenance finale, identique au PDF remis sur Moodle. |
Remplacez N et AAAA-MM-JJ par le numéro ou la date correspondants.
Placez les illustrations des documents près de ceux-ci et utilisez
des liens relatifs pour les afficher sur GitLab.
Faut-il déplacer le projet Godot ?
L’exemple fourni contient godot4/project.godot. Vous pouvez conserver
cette organisation. Si votre projet fonctionne déjà avec un autre
emplacement, gardez-le et indiquez-le dans le README.
Chaque membre clone la base commune sur sa machine. Il n’est pas nécessaire de créer un dossier de jeu par personne, par sprint ou par système. Conservez les licences et les crédits des éléments réutilisés.
Pour les fichiers à conserver ou à ignorer, notamment .godot/,
.import et .uid, et les déplacements de ressources, consultez
le guide Git et Godot.
Que mettre dans le README ?¶
Le nom du jeu et de l’équipe, ses membres et le Scrum Master.
La version exacte de Godot et le chemin de
project.godot.Les étapes pour ouvrir et lancer le jeu, ses commandes et son objectif.
La source et la révision du projet réutilisé, ainsi que les crédits utiles.
Les liens vers les documents existants, les PDF des présentations, les issues et les milestones.
Lorsque disponibles, la page itch.io et les instructions des versions distribuées.
Complétez les instructions progressivement. À partir du livrable 2, une autre équipe doit pouvoir les suivre sous Windows, macOS et Linux, avec Ubuntu comme environnement de test Linux. Consulter les exigences des livrables.
GitLab, fichiers ou Moodle ?¶
GitLab Issues : tâches, priorités, avancement et discussions. Les synthèses initiales conservent les choix du début ; elles ne deviennent pas une seconde liste de suivi.
Dépôt Git : jeu, documents partagés, PDF des présentations, licences et ressources utiles. Les exports du jeu restent hors du dépôt ; leur diffusion est précisée dans les consignes des livrables.
Moodle : fichiers et liens demandés à chaque rendu. Les bilans individuels sont privés : ne les placez pas dans le dépôt de l’équipe.
Remettre un lien vers une version précise
Enregistrez le document dans Git et envoyez les commits sur GitLab.
Ouvrez le fichier sur GitLab à la version à remettre.
Choisissez Copy Permalink, ou appuyez sur
ypuis copiez l’adresse obtenue.Vérifiez la version affichée et l’accès des encadrants avant le dépôt Moodle.
Ce lien identifie une version précise du fichier. Il ne fige pas les issues ou les pages externes auxquelles celui-ci renvoie. La consigne de chaque rendu précise qui effectue le dépôt et son échéance.
Pour travailler au quotidien : branches et intégration, issues et messages de commit.