Docs-as-code
Pages de la documentation sur le thème Docs-as-code (7 pages).
Ce thème regroupe 7 pages dans le manuel :
Parcours : 5. Constituer votre boîte à outilsCheck-lists
Une check-list pour faire migrer une équipe documentaire vers un workflow docs-as-code - gestion de versions, formats texte, CI/CD et préparation de l'équipe.
Parcours : 5. Constituer votre boîte à outilsExemples concrets
Un exemple abouti de pipeline CI/CD documentaire - build, vérification de liens, index de recherche et déploiement - annoté étape par étape.
Parcours : 5. Constituer votre boîte à outilsExemples concrets
Un exemple abouti d'un changement documentaire unique, de la branche à la fusion, sous un workflow docs-as-code calqué sur une revue de code standard.
Parcours : 5. Constituer votre boîte à outilsExemples concrets
Un exemple abouti d'organisation d'un dépôt docs-as-code - contenu par type d'information, langue en premier niveau pour un site traduit, et séparation nette de l'outillage.
Git : du fichier au contenu
ConceptParcours : 3. Adopter le docs-as-codeGit
Pensez contenu plutôt que fichiers avec Git : branches, commits et diffs pour la documentation technique simplifient la collaboration et la gestion des versions.
Parcours : 3. Adopter le docs-as-code
Découvrez pourquoi la documentation technique doit être livrée, versionnée et contrôlée en même temps que le produit, grâce aux formats texte comme DocBook, DITA XML et reStructuredText.
Parcours : 3. Adopter le docs-as-codeGit
Gérez la documentation technique avec Git ou Subversion comme du code source : suivez les modifications, collaborez en équipe et restaurez des versions.