Contribution
Conventions de code, de langue, de rédaction et de commit, procédure de publication du package et administration du registre.
Ces pages s'adressent à qui modifie @fraza/core lui-même, un package @fraza/module-* ou un module Pro @fraza-pro/module-*.
| Page | Sujet |
|---|---|
| Conventions de code | Standards, arborescence des features, suffixes de runtime, documentation. |
| Langue | Ce qui s'écrit en anglais, ce qui s'écrit en français. |
| Rédaction | Voix de l'interface, voix de la documentation, formules à éviter. |
| Commits | Format Conventional Commits, types, breaking changes. |
| Publication | Checklist, versionnage semver, npm publish. |
| Notes de version | Génération de CHANGELOG.md et changelog.json, pieds de commit, ce que fraza-update en tire. |
| Registre Verdaccio | Administration du registre : utilisateurs, packages, tags, droits. |
Règle qui prime sur les autres
On corrige la cause racine, jamais les symptômes. Si le même type d'erreur réapparaît dans un deuxième fichier après avoir corrigé le premier, c'est le signe que le vrai fix est ailleurs. Remonter la chaîne d'imports ou d'appels jusqu'à comprendre pourquoi ce code est atteint dans ce contexte, puis corriger à cet endroit.
Documentation
Toute la documentation vit dans docs/. Aucun fichier .md ne réside dans src/. Une modification de code n'est pas terminée tant que la page de docs/ concernée n'est pas à jour.
Propriété du code
Fraza suit un modèle open core. Le core et les modules de base sont sous licence MIT (Fraza Libre) : une contribution à ces paquets est reçue sous la même licence MIT que celle sous laquelle ils sont distribués, sans autre formalité. Les modules Facturation, Rendez-vous et Fichiers sont sous licence Fraza Pro : une contribution provenant d'une personne extérieure à HYKO exige une cession de droits écrite à HYKO avant la fusion, sans quoi son auteur reste titulaire du droit d'auteur sur son code. Ajouter une dépendance impose aussi de vérifier sa licence, aucune dépendance copyleft n'étant admise. Voir Licence et propriété.