Vue d’ensemble

L’embranchement dans Adobe Experience Manager Guides vous permet de créer et de gérer plusieurs branches en dehors de la branche principale pour qu’un plan DITA fonctionne sur différentes versions de documentation en parallèle. Chaque branche permet aux auteurs de gérer les modifications de contenu de manière indépendante, sans affecter le contenu correspondant dans les autres branches.

Avec l’embranchement, plusieurs équipes peuvent travailler simultanément sur différentes versions, fonctionnalités ou correctifs associés à un même plan DITA. Vous pouvez fusionner les modifications d’une branche dans la branche par défaut (main) lorsque les mises à jour sont prêtes.

Fonctionnement de l’embranchement

Vous pouvez créer une branche à partir de la principale ou de n’importe quelle branche existante d’un plan DITA. Après avoir créé une branche, vous pouvez y accéder et commencer à modifier la carte et son contenu. Vous pouvez également publier du contenu à partir de la branche sélectionnée ou fusionner les modifications dans main lorsque vous êtes prêt.

Prenons l’exemple d’un plan DITA nommé install-the-lift.ditamap qui contient les instructions d’installation d’un produit. Votre équipe de documentation peut créer deux branches de ce mappage à partir de main :

Les deux équipes peuvent travailler indépendamment sur leurs branches de carte respectives sans affecter les modifications de l’une et de l’autre.

Lorsque vous créez une branche d’un plan DITA, Experience Manager Guides ne copie pas automatiquement les rubriques référencées du plan dans la nouvelle branche. Les rubriques inchangées sont lues à partir de la branche source ou de la branche par défaut (principale). Une rubrique n’est copiée dans la nouvelle branche que lorsque vous la modifiez et l’enregistrez dans cette branche.

Par exemple, un plan DITA fait référence à 100 rubriques et le référentiel contient 50 rubriques supplémentaires qui ne sont pas référencées par le plan. Lorsque vous créez une branche (version 1.0), les 100 rubriques référencées font automatiquement partie de la version 1.0, même si aucune d’entre elles n’est modifiée. Les 50 rubriques non référencées ne font pas automatiquement partie de la nouvelle branche. Si vous modifiez 10 d’entre elles, seules ces 10 deviennent partie intégrante de la version 1.0. Les 40 autres rubriques inchangées continuent d’être utilisées à partir de la branche par défaut (principale).

Principaux avantages

L’utilisation d’une branche dans Experience Manager Guides offre les avantages suivants :

Branchement ou lignes de base

Une ligne de base identifie une combinaison spécifique de versions de rubrique pour un plan DITA, ce qui vous permet de générer une sortie à l’aide de ces versions sélectionnées.

Une branche fournit un environnement de modification distinct pour un plan DITA et son contenu, ce qui permet aux auteurs d’apporter des modifications sans affecter d’autres branches du même plan.

Fonctionnalités à venir

Les fonctionnalités suivantes ne sont actuellement prises en charge que dans la branche par défaut (main) et devraient l’être dans d’autres branches d’un plan DITA dans les prochaines versions de Experience Manager Guides :