Utiliser la boîte à outils
Des modèles, check-lists et exemples à copier directement dans votre propre projet. Chaque élément est clairement identifié comme modèle (un point de départ à adapter) ou exemple concret (une illustration aboutie à étudier).
Socle méthodologique
Section intitulée « Socle méthodologique »Typologie de l'informationLe socle architectural : Concepts, Tâches et Références, leur articulation avec DITA, et leur application dans nos modèles de rédaction.
Modèle d'article conceptDéfinition, pourquoi c'est important, principes clés, exemples, compromis.
Modèle d'article tâcheObjectif, prérequis, étapes, résultat attendu, dépannage.
Modèle d'article référenceAperçu, syntaxe, paramètres, exemples, limitations.
Modèle de documentation d'APIUn endpoint par page : méthode, paramètres, requête/réponse, codes d'erreur.
Plan de projet documentaireObjectif, public, périmètre, format, critères de succès, calendrier.
Demande de revue documentaireCadrer une revue pour qu'elle soit réellement effectuée.
Check-lists
Section intitulée « Check-lists »Qualité documentaireÀ exécuter avant de fusionner tout changement documentaire.
Revue techniqueCe qu'un relecteur expert métier doit et ne doit pas vérifier.
Préparation à la mise en productionUn jalon pour livrer la documentation avec une version du produit.
Migration documentaireChanger de format ou de plateforme sans perdre de contenu ni d'URL.
Adoption du docs-as-codeFormat, gestion de versions, CI/CD et préparation de l'équipe.
Audit documentaireRepérer les pages orphelines, doublons et contenus obsolètes.
Exemples
Section intitulée « Exemples »Une page Markdown bien structuréeUn article concept annoté, expliquant chaque choix structurel.
Une architecture de dépôt documentaireContenu langue-en-premier, séparé de l'outillage et des assets.
Un workflow docs-as-code basiqueUn changement, de la branche à la production, annoté étape par étape.
Un workflow de revue documentaireScinder revue technique et revue éditoriale, et pourquoi.
Un pipeline CI/CD concretBuild, tests, vérification de liens, prévisualisation, déploiement — annoté étape par étape.