Conventions
Aller à la navigation
Aller à la recherche
| Fiche express | |
|---|---|
| Domaine | Bonnes pratiques de développement |
| Portée | Codage (nommage, indentation) et intégration |
| Voir aussi | VCS, Git, UML |
Les conventions de développement sont l'ensemble des règles communes qu'une équipe adopte pour rendre le code lisible, homogène et maintenable. Elles ne changent pas ce que fait le programme, mais garantissent que chacun écrit et intègre de la même façon.
Normalisation du codage
- Convention de nommage — règles uniformes pour nommer variables, fonctions, classes et fichiers (casse, préfixes, langue) afin que le rôle d'un identifiant soit lisible d'un coup d'œil.
- Indentation — style d'indentation cohérent (espaces vs tabulations, largeur, placement des accolades) sur tout le projet, idéalement imposé par un outil de formatage automatique.
- Pratiques — commentaires utiles, fonctions courtes, gestion des erreurs homogène, absence de code mort.
Normalisation de l'intégration
Règles communes pour intégrer le travail de chacun sans friction : messages de commit normalisés, découpage des branches, revue de code avant fusion, et déclenchement des tests automatiques. Ces bases s'appuient directement sur le VCS utilisé (voir Git).