Doc:update

Documentation de fonctionnalité

Instructions à Exécuter

IMPORTANT : Exécute ce workflow étape par étape :

Génère ou met à jour la documentation pour la fonctionnalité en cours de développement, en s'assurant que tous les documents sont liés et que le README principal est à jour.

Purpose

Maintenir une documentation cohérente, à jour et bien interconnectée pour le projet.

Variables

• CURRENT_BRANCH: Branche Git en cours
• DOC_DIR: Répertoire de documentation du projet (détection automatique)
• README_PATH: Chemin vers le README principal du projet
• FEATURE_NAME: Nom de la fonctionnalité extraite de la branche et des modifications

Relevant Files

• README.md - Documentation principale du projet
• docs/ - Répertoire de documentation standard
• Fichiers source de la fonctionnalité
• Fichiers de tests associés

Workflow

1. Analyse du contexte

• Identifie la branche Git en cours (git branch --show-current)
• Analyse les modifications de la branche :
  • Fichiers modifiés (git status)
  • Diff par rapport à main/master (git diff)
  • Commits de la branche (git log)
• Extrait le nom de la fonctionnalité depuis :
  • Le nom de la branche (ex: feature/user-auth → User Authentication)
  • Les commits de la branche
  • Les prompts récents de la session
• Détermine le répertoire de documentation :
  • Cherche docs/, documentation/, ou équivalent
  • Crée le répertoire si nécessaire
• Identifie les informations clés :
  • Fichiers principaux modifiés
  • Tests associés
  • Dépendances ajoutées/modifiées

2. Génération de la documentation

• Crée ou met à jour le fichier de documentation :
  • Titre et description claire
  • Utilisation et exemples
  • Architecture et composants
  • Configuration nécessaire
  • Tests et validation
  • Limitations et notes
• Format Markdown structuré avec :
  • Table des matières si nécessaire
  • Blocs de code avec syntaxe
  • Liens vers fichiers sources
  • Exemples d'utilisation concrets

3. Mise à jour du README principal

• Vérifie si la fonctionnalité doit être mentionnée dans le README
• Ajoute ou met à jour la section appropriée :
  • Fonctionnalités principales
  • Structure du projet
  • Documentation disponible
• Maintient la cohérence du format existant
• Préserve l'ordre et la hiérarchie

4. Liaison des documents

• Identifie les documents connexes :
  • Documentation de fonctionnalités liées
  • Guides d'architecture
  • Tutoriels
  • ADRs (Architecture Decision Records)
• Ajoute des liens bidirectionnels :
  • Depuis le nouveau document vers les connexes
  • Depuis les connexes vers le nouveau document
• Vérifie l'absence de liens cassés
• Crée un index si nécessaire pour les projets volumineux

5. Validation et rapport

• Vérifie la qualité de la documentation :
  • Tous les exemples sont fonctionnels
  • Les liens sont valides
  • Le formatage Markdown est correct
  • Pas de typos évidentes
• Génère un rapport de ce qui a été créé/modifié

Report

Affiche un résumé structuré :

Documentation générée :
- Fonctionnalité : [NOM]
- Fichier créé/modifié : [CHEMIN]
- Taille : [LIGNES] lignes

Modifications README :
- Section modifiée : [SECTION]
- Ajouts : [DESCRIPTION]

Liens créés :
- [DOC1] ↔ [DOC2]
- [DOC3] ↔ [DOC4]

Documents liés :
- [LISTE DES DOCS CONNEXES]

Best Practices

• Documentation focalisée sur l'utilisation, pas l'implémentation
• Exemples concrets et testés
• Langage clair et concis (style bullet points)
• Liens relatifs pour la portabilité
• Pas de duplication entre README et docs détaillées
• README = vue d'ensemble, docs/ = détails
• Maintenir la cohérence du ton et du format