docs: init (#1)

Co-authored-by: Djelal BOUDJI <djelal2004@gmail.com>
This commit is contained in:
Théo LUDWIG 2024-11-18 10:41:45 +01:00 committed by GitHub
parent f5bac6360d
commit a297f92f03
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 68 additions and 0 deletions

31
README.md Normal file
View File

@ -0,0 +1,31 @@
# CNAM Geometry Dash
## À propos
Développement d'une reproduction du jeu [Geometry Dash](https://fr.wikipedia.org/wiki/Geometry_Dash) réalisé dans le cadre de la formation [Ingénieur en Informatique et Systèmes d'Information (SI), CNAM](https://www.itii-alsace.fr/formations/informatique-et-systemes-dinformation-le-cnam/), pour les modules de Programmation Orientée Objet (POO) et de Méthodologie Systèmes d'Informations.
### Membres du groupe
- [Djelal BOUDJI](https://github.com/djelalb)
- [Théo LUDWIG](https://github.com/theoludwig)
- [Vincent PETT](https://github.com/Vextriz)
### Documentation
- [Sujet](./docs/Sujet-Projet-Geometry-Dash.pdf)
- [Conventions développement informatique](./docs/conventions.md)
- [Kanban Board (Trello)](https://trello.com/b/ugG5Siaw/cnam-geometry-dash)
## Prérequis
[Unity](https://unity.com/)
## Installation
```sh
# Cloner le dépôt
git clone git@github.com:boudji-ludwig-pett/cnam-geometry-dash.git
# Se déplacer dans le dossier du projet
cd cnam-geometry-dash
```

Binary file not shown.

37
docs/conventions.md Normal file
View File

@ -0,0 +1,37 @@
# Conventions développement informatique
## GitFlow
Le projet suit la convention [GitFlow](https://nvie.com/posts/a-successful-git-branching-model/) reposant sur 3 branches principales :
- `main` : Contient le code de la dernière version stable et déployé en production.
- `staging` : Contient le code en cours de test avant déploiement en production, Quality Assurance (QA).
- `develop` : Contient le code en cours de développement. Les nouvelles fonctionnalités et les correctifs de bugs sont fusionnés ici régulièrement.
Idéalement, chaque nouvelle fonctionnalité ou correctif de bug est développé dans une branche dédiée à partir de `develop`, nommée `feat/<nom-de-la-fonctionnalité>` ou `fix/<nom-du-bug>`. Une fois le développement terminé, une pull request est créée pour demander une revue de code, et une fois validée, la branche est fusionnée dans `develop`, puis supprimée.
## Convention des commits
Les commits respectent la convention [Conventional Commits](https://www.conventionalcommits.org/) et [Semantic Versioning](https://semver.org/) pour la gestion des versions et des releases en fonction des commits.
Les commits doivent être **atomiques**, c'est-à-dire qu'ils respectent les 3 règles suivantes :
- Ne concernent qu'un seul sujet (une fonctionnalité, une correction de bug, etc.).
- Doivent avoir un message clair et concis.
- Ne doivent pas rendre le dépôt "incohérent" (ne bloquent pas la CI du projet).
## Pull Requests (PR)
Lorsqu'une Pull Request (PR) est créée, il est obligatoire d'ajouter un **Reviewer**. Le rôle du Reviewer est d'effectuer une **code review** pour garantir la qualité et la conformité du code soumis avant sa fusion dans la branche cible. L'approbation du Reviewer est nécessaire pour fusionner la PR.
### Processus de revue de code
1. **Code Review** :
- Examiner le code pour détecter les erreurs ou les violations des bonnes pratiques.
- Vérifier la clarté, la lisibilité et la maintenabilité du code.
2. **Commentaires** :
- Les commentaires doivent suivre les [Conventional Comments](https://conventionalcomments.org/), qui permettent de structurer les retours de manière cohérente et compréhensible.
3. **Validation** :
- Une fois tous les retours pris en compte et les corrections appliquées, le Reviewer peut approuver la PR, permettant ainsi sa fusion.