Files
khadhroony-bot3/docs/templates/CRATE_USAGE_TEMPLATE.md
2026-07-31 13:25:47 +02:00

1.2 KiB
Raw Blame History

Modèle de guide dutilisation de crate

Documenter uniquement la surface publique réellement accessible aux consommateurs.

Utilisation de <nom-de-crate>

Objectif

Prérequis

Dépendance et features

Configuration

Vue densemble de lAPI publique

APIs publiques significatives

Pour chaque API ou groupe cohérent :

  • chemin public ;
  • rôle ;
  • paramètres ou types associés ;
  • valeur retournée ;
  • erreurs ;
  • invariants ;
  • exemple.

Types publics importants

Erreurs et invariants

Exemples

Utilisation du binaire

Supprimer cette section si aucun binaire public nexiste.

Contraintes et limites durables

Tests de référence

Lister uniquement les tests unitaires ou dintégration qui constituent des exemples particulièrement instructifs de lutilisation réelle de la crate, de ses invariants ou de ses parcours Devnet/Mainnet. Ne pas produire un catalogue exhaustif de tous les tests.

Références

Lier les autres exemples, fixtures et matrices canoniques sans les dupliquer.

Ne pas répéter ici une limite temporaire déjà planifiée dans TODO.md. Les exemples Rust doivent respecter les règles du workspace.