Skip to content

Commit

Permalink
Merge pull request #14 from ETS-TAF/feature/add_convention_doc
Browse files Browse the repository at this point in the history
Add Convention_code_sheet
  • Loading branch information
Descharges authored Oct 19, 2023
2 parents 19d4ba6 + e1726e7 commit cd9b494
Show file tree
Hide file tree
Showing 2 changed files with 36 additions and 0 deletions.
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -36,3 +36,4 @@ bin

# local config
application-local.yml
node_modules
35 changes: 35 additions & 0 deletions documentation/CONVENTIONS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,35 @@
# TAF - Conventions d'écriture
Dernière mise à jour : 16/10/2023

---

## TypeScript - Framework Angular
- Noms des fonctions et variables en CamelCase : `thisIsAVariable`
- Constantes en MAJUSCULE avec le mot clé `readonly` : `readonly VARIABLE_CONSTANTE: string = "const";`
- Commentaires : `// + phrase en anglais``// this is a comment`
- Code typé strictement
- Appels API définis dans les services
- Suivre les standards Angular : [Lien vers le guide de style Angular](https://angular.io/guide/styleguide)

## Java - Framework Spring
- Programmation orientée objet avec classes et interfaces
- Utiliser le modèle MVC proposé par Spring (controller, services, repositories etc)
- Noms des fonctions et variables en CamelCase : `thisIsAVariable`
- Noms des classes, interfaces et énumérations en PascalCase : `ThisIsAClass`
- Commentaires : `// + phrase en anglais``// this is a comment`
- Constantes en MAJUSCULE avec le mot clé `final` : `final String VARIABLE_CONSTANTE = "const";`
- Injection de dépendances de Spring, éviter d'utiliser 'new' pour instancier des dépendances
- Suivre les conventions de programmation Java et Spring
**Que ce soit pour le frontend ou le backend : les noms des variables, méthodes, classes, énumérations... doivent être explicites et définir le plus clairement possible leur fonction.**

## GIT Flow
- Message de commit sous la forme : "Action verb + élément concerné" écrit en anglais
- Utiliser en majorité ces action verbs : Add, Fix, Remove, Update, Improve (toujours au présent)
-> `git commit -m "Add color enumeration"`
- Un commit par changement
- 3 types de branches :
- Main : branche de la version stable actuellement en production
- Develop : branche de la version en phase de test qui sert de référence aux branches feature
- Feature : branche créée pour ajouter une feature au programme. On la nomme : `feature/userstory_id-résumé_feature`
- Fonctionnement : Pour créer une nouvelle feature il faut créer une branche depuis develop, une fois développée, il faut créer une pull request pour pouvoir merger la nouvelle feature sur develop

0 comments on commit cd9b494

Please sign in to comment.