Guide du Contributeur

Cette section vous guide pas à pas pour contribuer à KoproGo, de l’installation à votre première pull request.

Tip

Nouveau contributeur ? Suivez le Bienvenue dans la Communauté KoproGo ! pour un parcours guidé complet.

Contenu de cette Section

Vue d’Ensemble

Étapes pour Contribuer

  1. Comprendre le projet : Lisez Pourquoi KoproGo Existe

  2. Installer localement : Suivez installer-projet

  3. Choisir une issue : “good first issue” sur GitHub

  4. Coder avec TDD : Tests d’abord, puis implémentation

  5. Ouvrir une PR : Suivez faire-premiere-contribution

Prérequis Système

  • Rust 1.83+ (rustup)

  • Node.js 18+ & npm

  • PostgreSQL 15+

  • Docker (optionnel)

  • Git 2.30+

Philosophie de Contribution

✅ Tests d’abord (TDD) ✅ Code propre (rustfmt, clippy) ✅ Documentation synchronisée ✅ Commits signés (DCO) ✅ Reviews constructives

Documents

premiers-pas

Premiers pas pour contribuer : prérequis, cloner le repo, explorer les issues, rejoindre la communauté.

installer-projet

Installation pas-à-pas du projet localement : Rust, PostgreSQL, Docker, configuration, lancement des tests.

faire-premiere-contribution

Workflow Git complet : branches, TDD, commits, pull requests, reviews, checklist PR.

comprendre-rfc-adr

Qu’est-ce qu’une RFC ? Un ADR ? Comment proposer une RFC ? Processus d’approbation.

standards-code

Conventions de code : Rust (rustfmt, clippy), TypeScript (ESLint), commits (conventional commits), DCO.

Ressources Complémentaires

Section Guide du Contributeur - Documentation KoproGo ASBL