sdk_relay/CONTRIBUTING.md

1.7 KiB
Raw Blame History

Guide de Contribution - sdk_relay

Merci pour votre intérêt à contribuer à sdk_relay ! Ce guide explique comment participer efficacement.

🎯 Types de contributions

  • Bugs, nouvelles fonctionnalités, documentation, tests, performance, sécurité

🚀 Premiers pas

Prérequis

  • Rust stable (via rustup)
  • Docker (pour intégration dans 4NK Node)
  • Git

Fork & clone (Gitea)

git clone https://git.4nkweb.com/4nk/sdk_relay.git
cd sdk_relay
# Ajouter upstream si vous travaillez depuis un fork
# git remote add upstream https://git.4nkweb.com/4nk/sdk_relay.git

Branches

git checkout -b feature/nom-feature
# ou
git checkout -b fix/nom-bug

🔧 Développement

Build & tests

cargo fmt --all
cargo clippy --all-targets -- -D warnings
cargo test --all

Messages de commit (conventionnel)

type(scope): description courte
# ex: feat(sync): add metrics sync type

Types: feat, fix, docs, style, refactor, test, chore, perf, ci

🧪 Tests

Unitaires / Intégration

cargo test --lib --bins
cargo test --tests

Lint / Format

cargo fmt --all -- --check
cargo clippy --all-targets -- -D warnings

📚 Documentation

  • Maintenir à jour README.md et docs/
  • Documenter les APIs publiques et les nouveaux types de sync

🔍 Code Review

  • CI verte (fmt, clippy, tests)
  • Couverture de tests suffisante
  • Pas de régressions
  • Perf et sécurité considérées

📝 Pull Requests (Gitea)

  • Lier une issue si possible
  • Décrire clairement les changements
  • Ajouter tests et docs

🆘 Support

📄 Licence

Contribuer implique lacceptation de la licence MIT du projet.