Panoramica
La creazione di rami in Adobe Experience Manager Guides consente di creare e gestire più rami del ramo principale affinché una mappa DITA funzioni in parallelo su diverse versioni della documentazione. Ogni ramo consente agli autori di gestire le modifiche al contenuto in modo indipendente, senza influire sul contenuto corrispondente in altri rami.
Con la creazione di diramazioni, più team possono lavorare contemporaneamente su diverse versioni, funzioni o correzioni associate alla stessa mappa DITA. È possibile unire le modifiche da un ramo al ramo predefinito (main) quando gli aggiornamenti sono pronti.
Funzionamento della diramazione
È possibile creare un ramo da main o da qualsiasi ramo esistente di una mappa DITA. Dopo aver creato un ramo, puoi passare ad esso e iniziare a modificare la mappa e il relativo contenuto. Puoi anche pubblicare il contenuto dal ramo selezionato o unire le modifiche in main quando è pronto.
Si consideri, ad esempio, una mappa DITA denominata install-the-lift.ditamap che contiene istruzioni di installazione per un prodotto. Il tuo team di documentazione può creare due rami di questa mappa da main:
- Versione 1: Il team A mantiene le istruzioni di installazione esistenti e le correzioni degli indirizzi.
- Versione 2: Il team B sviluppa le istruzioni di installazione per le nuove funzionalità.
Entrambi i team possono lavorare in modo indipendente sui rispettivi rami della mappa senza influire sulle modifiche reciproche.
Quando si crea un ramo di una mappa DITA, Experience Manager Guides non copia automaticamente gli argomenti di riferimento della mappa nel nuovo ramo. Gli argomenti non modificati vengono letti dal ramo di origine o dal ramo predefinito (principale). Un argomento viene copiato nel nuovo ramo solo quando lo si modifica e lo si salva in tale ramo.
Ad esempio, una mappa DITA fa riferimento a 100 argomenti e il repository contiene 50 argomenti aggiuntivi ai quali la mappa non fa riferimento. Quando crei un nuovo ramo (versione 1.0), tutti i 100 argomenti a cui si fa riferimento diventano automaticamente parte della versione 1.0, anche se nessuno di essi viene modificato. I 50 argomenti senza riferimenti non diventano automaticamente parte del nuovo ramo. Se ne modifichi 10, solo queste 10 diventano parte della release-1.0. I rimanenti 40 argomenti non modificati continuano a essere utilizzati dal ramo predefinito (principale).
Vantaggi chiave
L’utilizzo di una filiale in Experience Manager Guides offre i seguenti vantaggi:
- Modifica isolata: apporta modifiche all’interno di un ramo mappa selezionato senza influire sul contenuto corrispondente in altri rami.
- Authoring parallelo: consente a più team di lavorare simultaneamente su diverse versioni, funzionalità o correzioni all’interno dei rispettivi rami di mappa.
- Pubblicazione indipendente: Pubblica la documentazione da singoli rami di mappa senza attendere il completamento delle modifiche in altri rami.
- Unione controllata: unire le modifiche da un ramo mappa al ramo predefinito (
main), con la possibilità di esaminare e risolvere i conflitti.
Branching e linee di base
Una baseline identifica una combinazione specifica di versioni di argomenti per una mappa DITA, consentendo di generare l’output utilizzando le versioni selezionate.
Un branch fornisce un ambiente di modifica separato per una mappa DITA e il relativo contenuto, consentendo agli autori di apportare modifiche senza influire su altri rami della stessa mappa.
Funzionalità future
Le funzionalità seguenti sono attualmente supportate solo nel ramo predefinito (main) e sono previste per essere supportate in altri rami di una mappa DITA nelle versioni future di Experience Manager Guides:
- Ricerca
- Trova e sostituisci
- Rivedere i flussi di lavoro