ZELMO se construitavec sacommunauté.

Toutes les contributions comptent

Un logiciel open source ne vit pas seulement grâce à ceux qui écrivent son code. Il vit grâce à ceux qui signalent précisément un bug, qui expliquent un besoin métier concret, qui corrigent une phrase confuse dans la documentation, qui traduisent une interface, ou qui prennent le temps de répondre à une question d’un autre utilisateur.

Si vous utilisez ZELMO, vous avez déjà tout ce qu’il faut pour contribuer. Cette page décrit chaque voie possible, de la plus simple à la plus technique.

Contribuer sans écrire de code

Signaler un bug

Ouvrez une issue « bug ». Un bon rapport contient : ce que vous faisiez, ce que vous attendiez, ce qui s’est produit à la place, les étapes exactes pour reproduire, votre version de ZELMO et, si possible, une capture d’écran ou un extrait de journal. Un bug reproductible est corrigé bien plus vite.

Proposer une fonctionnalité

Ouvrez une issue « proposition » et décrivez d’abord le problème métier, pas la solution technique : qui est concerné, à quelle fréquence, ce que cela coûte aujourd’hui. Les meilleures idées viennent souvent d’un cas d’usage précis vécu sur le terrain.

Traduire l’interface

ZELMO est nativement en français. Les traductions vers d’autres langues passent par les fichiers de localisation du dépôt et suivent le même circuit qu’une contribution de code. Aucune connaissance en programmation n’est nécessaire pour traduire des chaînes de texte.

Améliorer la documentation

Une étape manquante, un exemple qui ne marche plus, une formulation ambiguë : la documentation se corrige exactement comme le code, via une pull request. C’est souvent la meilleure première contribution.

Aider la communauté

Répondre à une question dans les discussions, confirmer qu’un bug touche aussi votre installation, tester une version candidate : ce travail de l’ombre allège la charge des mainteneurs et accélère tout le reste.

Contribuer du code, étape par étape

1. Préparer son environnement

Le fichier CONTRIBUTING.md du dépôt décrit comment lancer ZELMO en local (dépendances, base de données de développement, variables d’environnement). Vérifiez que l’application démarre et que les tests passent avant toute modification.

2. Choisir une tâche

Parcourez les issues ouvertes. Celles marquées « good first issue » sont volontairement circonscrites et bien décrites : idéales pour une première contribution. Commentez l’issue pour signaler que vous la prenez, afin d’éviter les doublons.

3. Forker et créer une branche

Créez un fork du dépôt sur votre compte, puis une branche au nom explicite (par exemple fix/relance-tva-arrondi). Travaillez toujours sur une branche dédiée, jamais directement sur la branche principale.

4. Respecter les conventions

• Suivez le style de code du projet — le formatage et le lint sont automatisés
• Écrivez des messages de commit clairs et concis, un commit par idée
• Ajoutez ou mettez à jour les tests couvrant votre changement
• Mettez à jour la documentation si le comportement visible change

5. Ouvrir la pull request

Rédigez une description qui explique le pourquoi autant que le comment, référencez l’issue concernée, et joignez une capture d’écran pour tout changement visuel. Les vérifications automatiques (tests, lint, build) se lancent seules.

6. La revue

Un mainteneur relit votre proposition, pose des questions et suggère parfois des ajustements. C’est un échange, pas un jugement : les allers-retours font partie du processus et améliorent le résultat. Poussez simplement de nouveaux commits sur la même branche pour répondre aux retours.

7. Après la fusion

Une fois fusionnée, votre contribution part dans la prochaine version et vous apparaissez dans la liste des contributeurs. Vous pouvez ensuite supprimer votre branche et en démarrer une nouvelle.

Code de conduite et licence

Le projet suit un code de conduite : les échanges se font avec respect et bienveillance, quelle que soit l’expérience de chacun. Les comportements agressifs ou excluants ne sont pas tolérés.

En soumettant une contribution, vous acceptez qu’elle soit distribuée sous la licence AGPLv3 du projet et vous attestez avoir le droit de la proposer. Vous restez l’auteur de votre travail. Le détail figure dans le fichier CONTRIBUTING.md.