Contribuer
Contribution
CSS / SASS
- Utiliser
rem pour les tailles (font-size, margin, padding, gap, width, height) afin de conserver une UI scalable.
- Garder
px uniquement quand c'est strictement nécessaire (bordures fines, hairlines, contraintes liées à un asset).
- Préférer les propriétés logiques CSS :
margin-inline, margin-block, padding-inline, padding-block
inset-inline-start / inset-inline-end / inset-block-start / inset-block-end
border-inline, border-block
- Éviter
top / right / bottom / left quand l'intention est directionnelle (compatibilité LTR/RTL).
- Favoriser les variables de design déjà présentes dans
variables/ plutôt que des valeurs "en dur".
- Garder la nomenclature de classes existante et limiter la profondeur de sélecteurs.
Linting et qualité
- Le lint CSS est obligatoire avant commit.
npm run lint
- Le pre-commit Husky exécute déjà ce lint.
- Respecter les règles définies dans
.stylelintrc.json (ordre des propriétés, règles SCSS, propriétés autorisées).
- Pour tout code JavaScript/TypeScript ajouté ou modifié, appliquer aussi un lint
eslint sur le module concerné.
Règles de contribution
- Faire des commits petits et ciblés (un changement fonctionnel par commit).
- Vérifier localement que le build est vert avant push.
- Documenter tout nouveau composant (fichiers
.md + exemple .jsp dans la documentation).