Gestion de versions
Pages de la documentation sur le thème Gestion de versions (9 pages).
Ce thème regroupe 9 pages dans le manuel :
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-codeConception du référentiel
Dans un CMS comme Drupal, Joomla ou WordPress, le contenu documentaire est stocké en base SQL, qui ne conserve qu'un historique article par article et interdit la recherche-remplacement globale - d'où l'intérêt de le gérer en fichiers texte.
Parcours : 3. Adopter le docs-as-codeConception du référentiel
Un CMS comme SharePoint ou Alfresco apporte workflow et verrouillage des fichiers à la rédaction technique, et certains (DocZone, Componize) gèrent même DITA XML - mais leur fiabilité pour archiver les sources reste à tester, adossée à une sauvegarde éprouvée.
Parcours : 3. Adopter le docs-as-codeConception du référentiel
Les répertoires réseau partagés sont une solution inadaptée pour la documentation d'équipe. Pourquoi ils posent problème et quelles alternatives choisir pour collaborer.
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.
Parcours : 3. Adopter le docs-as-codeConception du référentiel
Pourquoi les dossiers et disques réseau partagés montrent leurs limites en travail de groupe : les modifications concurrentes s'écrasent, le verrouillage des fichiers bloque les changements par lot et impose une coordination de tous les instants.
Référentiel
ConceptParcours : 3. Adopter le docs-as-codeConception du référentiel
Le contenu technique est un capital immatériel précieux. Découvrez comment choisir et gérer un référentiel documentaire pour le versionner, le protéger et le partager.
Un référentiel unique ?
ConceptParcours : 3. Adopter le docs-as-codeConception du référentiel
Un référentiel Git unique pour la documentation technique maximise la réutilisation, la cohérence et la qualité, tout en simplifiant la collaboration en équipe.
Parcours : 3. Adopter le docs-as-code
Utilisez les branches Git pour gérer des projets documentaires parallèles, des variantes produit et des workflows de traduction sans conflits - guide pratique rédacteur.