Contribuer

Le dépôt n'est pas encore ouvert aux contributions externes

L'accord existe pour qu'il puisse l'être sans improviser le jour venu. Les rapports de bogue et les remarques de conception, eux, sont les bienvenus dès maintenant.

Ce qui ne demande aucune formalité

Signaler un bogue. Proposer une évolution. Contester un choix de conception. Relire la documentation et dire ce qui n'y est pas clair.

Sur un outil de gestion de crise, un rapport précis — ce que vous faisiez, ce que vous attendiez, ce qui s'est passé — vaut souvent davantage qu'un correctif.

Ce qui demande une signature

Soumettre du code, de la documentation, une traduction, un jeu de vérification.

1. S'inscrire au registre — une ligne dans accords/registre.md, dans votre première demande de fusion. Cette ligne est la signature.
2. Signer ses commits — git commit -s, soit le Developer Certificate of Origin 1.1.

Le contributeur garde son droit d'auteur et accorde une licence large, relicenciement compris. En contrepartie, l'accord engage le projet : publication libre immédiate, aucun retrait de ce qui a été publié, cœur maintenu sous licence libre.

Si vous contribuez dans le cadre de votre emploi, c'est l'accord entité qu'il faut : en droit français, les droits sur un logiciel écrit par un salarié dans l'exercice de ses fonctions appartiennent à son employeur.

Ce qu'on attend d'un correctif

pnpm typecheck && pnpm verif && pnpm accords

Une garantie de plus dans pnpm verif. Un correctif sans contrôle qui échouait avant et passe après n'est pas fini.

La règle à ne jamais enfreindre. Toute mutation de l'état d'une crise passe par enregistrer(). Un insert direct dans une table de projection produit un état que le rejeu ne reconstruira pas — c'est-à-dire une boîte noire qui ment.

Des commentaires qui disent pourquoi. Un commentaire qui paraphrase la ligne suivante sera retiré ; un commentaire qui dit pourquoi cette ligne n'est pas ce qu'on ferait ailleurs sera gardé.

Le français. Noms de fonctions, de tables, de variables, de routes, messages d'erreur, commentaires.

Les messages d'erreur s'adressent à quelqu'un sous pression. Ils disent ce qui s'est passé et quoi faire ensuite.

Signaler une faille de sécurité

N'ouvrez pas de ticket public

Écrivez à contact@kourser.bzh, en décrivant le chemin d'exploitation et l'effet obtenu.

Kastell sert précisément quand le système d'information est compromis. Une faille publiée avant correction ne gêne pas un éditeur : elle atteint des organisations déjà attaquées.