Contribuer

Contribuer à ediverse

ediverse est un projet communautaire ouvert. Quatre voies de contribution sont prévues, de la correction d'une coquille à la proposition d'une nouvelle page sourcée.

Quatre manières de contribuer

Le lecteur peut intervenir selon le niveau d'effort qui lui convient, du signalement ponctuel à l'auteurat d'une page complète :

1. Signaler une correction — coquille, lien mort, exemple erroné, fait obsolète. Une issue GitHub avec l'URL de la page concernée et la nature de la correction suffit. Idéal lorsqu'on est lecteur plutôt que rédacteur.
2. Proposer une nouvelle page — un segment EDIFACT manquant, un message peu documenté, un nouveau standard. La proposition passe par une issue d'abord, puis par une pull request lorsque le périmètre est validé.
3. Soutenir le projet — l'inscription à la newsletter mensuelle finance indirectement le temps éditorial. Le sponsoring formel via GitHub Sponsors est ouvert aux entreprises souhaitant être listées dans la page de remerciements (sans contrepartie éditoriale).
4. Partager — citer une page dans un article, un cours, une réponse Stack Overflow, ou un manuel d'intégration interne. La citation avec lien fait progresser la visibilité du projet et incite d'autres praticiens à contribuer.

Workflow d'une contribution éditoriale

Pour qu'une contribution éditoriale soit acceptable, elle doit suivre le même processus que la rédaction interne. Le contributeur ouvre d'abord une issue avec :

• la nature de l'ajout ou de la correction proposée ;
• l'URL de la source primaire qui justifie le contenu (par exemple un fichier UNECE UN/CEFACT, une DTD cXML, une RFC de l'IETF) ;
• la licence applicable à la source (libre, propriétaire, paywall) ;
• une justification rapide de l'intérêt pour la communauté EDI.

Une fois l'issue acceptée par la rédaction, le contributeur ouvre une pull request. La pull request doit :

• passer le typecheck pnpm typecheck et le build pnpm build ;
• archiver la source primaire sous content/_sources/ avec un fichier PROVENANCE.md ;
• respecter le ton éditorial : troisième personne, pas de tutoiement, citations sourcées, examples didactiques originaux pour les spécifications propriétaires ;
• fournir une traduction parallèle FR/EN, ou marquer explicitement la page comme partielle pour traduction ultérieure.

Politique de sourcing

La règle est stricte : aucun fait technique ne peut être publié sans citation. Trois catégories de sources sont admises :

• Sources publiques libres : annuaires UNECE UN/EDIFACT, profils OASIS UBL, profils OpenPEPPOL, RFC IETF. Reproductibles intégralement, avec attribution.
• Sources publiques restrictives : index public ANSI ASC X12 (noms et codes des transaction sets), PDF de référence SAP OCI. Seuls les éléments rendus publics par l'éditeur sont citables ; le détail des Implementation Guides reste hors périmètre.
• Sources propriétaires payantes : ISO 9735, X12 TR3, etc. Non reproductibles. La couverture éditoriale se limite au niveau conceptuel et à des exemples didactiques originaux conformes au droit de courte citation.

Code de conduite

Toute interaction sur le dépôt public — issues, pull requests, discussions — est régie par un code de conduite calqué sur le Contributor Covenant. Le principe directeur est simple : discussions techniques, respect mutuel, focalisation sur le contenu et non sur les personnes. Le code complet sera publié à la racine du dépôt à l'ouverture publique des contributions.

Reconnaissance des contributeurs

Chaque contribution acceptée est tracée par l'historique Git et associée à un identifiant publié dans le dépôt. Les contributeurs qui le souhaitent peuvent figurer dans la page de remerciements. ediverse ne demande pas de cession de droits : le contributeur conserve ses droits moraux sur sa contribution, et accepte une licence d'usage compatible avec la licence éditoriale du site.

Contact

Pour toute question préalable à une contribution importante, ou pour signaler un problème juridique (copyright, marque, données personnelles), le contact de référence est contact@ediverse.io. Les correspondances techniques ordinaires passent directement par le dépôt GitHub.