Génère une documentation exhaustive pour le code suivant. Langage : [PRÉCISER]. Format de documentation : [JSDOC/SPHINX/GODOC/RUSTDOC/etc.]
Code :
[COLLER LE CODE]
Génère : 1) Des docstrings pour les fonctions/méthodes avec paramètres, types de retour et exceptions, 2) Des commentaires inline pour la logique non évidente, 3) Une vue d'ensemble au niveau du module, 4) Des exemples d'utilisation couvrant les cas les plus courants, 5) Une section README décrivant l'objectif du module, ses dépendances et son utilisation. Respecte les conventions [LANGAGE]. Signale les sections de code trop complexes qui mériteraient d'être refactorisées plutôt que simplement documentées.