Adopter le docs-as-code

Gestion de versions, branches et intégration continue appliquées à la documentation - accompagnées des didacticiels pratiques pour l’outillage de traitement de texte et d’automatisation dont ce workflow dépend.

Processus et outillage

Intégrer la documentation aux processus de développementAligner cadence de livraison, gestion de versions, tests automatisés et pipelines CI/CD.

Les systèmes de gestion de versionsPourquoi la gestion de versions compte aussi pour la documentation, pas seulement pour le code.

Git : du fichier au contenuPenser Git comme un historique de contenu, pas seulement de fichiers.

Utiliser les branchesStratégies de branches pour le travail documentaire en parallèle.

Le référentielCe qui doit figurer dans un référentiel documentaire, et comment le structurer.

Un référentiel uniqueL'argument en faveur d'un référentiel commun pour la documentation et le code.

Quel référentiel pour le travail de groupeChoisir un modèle de référentiel quand plusieurs rédacteurs collaborent.

Les répertoires réseau partagésPourquoi les lecteurs partagés ne suffisent pas pour un travail documentaire collaboratif.

Les bases de données SQLQuand un référentiel adossé à une base de données a du sens — et quand ce n'est pas le cas.

Workflow CMS et fiabilitéLes bénéfices d'un CMS en termes de workflow, mis en balance avec ses compromis de fiabilité.

Didacticiels pratiques

sed : modifiez votre texte sans ouvrir vos fichiersRechercher-remplacer en masse sur des centaines de fichiers en une seule commande.

Expressions régulières en PythonManipulation de texte pour les scripts d'automatisation documentaire.

Le Raspberry Pi 3 comme plateforme de documentationUn pipeline de publication minimal et à faible coût.

Mener un projet de bout en boutUn projet suivi de la prise en charge jusqu'à la livraison.

Vous travaillez avec DITA XML ou le single-sourcing ? Voir la rédaction structurée.