Información general
La bifurcación en Adobe Experience Manager Guides le permite crear y administrar varias ramas desde la rama main para que un mapa DITA funcione en diferentes versiones de documentación en paralelo. Cada rama permite a los autores administrar los cambios de contenido de forma independiente, sin afectar al contenido correspondiente en otras ramas.
Con la bifurcación, varios equipos pueden trabajar simultáneamente en distintas versiones, funciones o correcciones asociadas al mismo mapa DITA. Puede combinar los cambios de una rama en la rama predeterminada (main) cuando las actualizaciones estén listas.
Funcionamiento de la bifurcación
Puede crear una rama a partir de main o cualquier rama existente de un mapa DITA. Después de crear una rama, puede cambiar a ella y comenzar a editar el mapa y su contenido. También puede publicar contenido de la rama seleccionada o combinar cambios en main cuando esté listo.
Por ejemplo, considere un mapa DITA denominado install-the-lift.ditamap que contenga instrucciones de instalación para un producto. Su equipo de documentación puede crear dos ramas de este mapa a partir de main:
- Versión 1: El equipo A mantiene las instrucciones de instalación existentes y corrige las direcciones.
- Versión 2: Equipo B desarrolla instrucciones de instalación para nuevas características.
Ambos equipos pueden trabajar de forma independiente en sus respectivas ramas de mapas sin afectar a los cambios de los demás.
Cuando se crea una rama de un mapa DITA, Experience Manager Guides no copia automáticamente los temas a los que se hace referencia en el mapa en la nueva rama. Los temas que no han cambiado se leen desde la rama de origen o la rama predeterminada (principal). Un tema se copia en la nueva rama solo cuando lo edita y lo guarda en esa rama.
Por ejemplo, un mapa DITA hace referencia a 100 temas y el repositorio contiene 50 temas adicionales a los que el mapa no hace referencia. Al crear una rama nueva (versión 1.0), los 100 temas a los que se hace referencia pasan a formar parte automáticamente de la versión 1.0, aunque no se edite ninguno de ellos. Los 50 temas a los que no se hace referencia no pasan a formar parte automáticamente de la nueva rama. Si edita 10 de ellos, solo esos 10 pasan a formar parte de la versión 1.0. Los 40 temas restantes sin cambios se siguen utilizando desde la rama predeterminada (principal).
Ventajas principales
Trabajar con una rama en Experience Manager Guides ofrece las siguientes ventajas:
- Edición aislada: Realice cambios dentro de una rama de mapa seleccionada sin afectar al contenido correspondiente en otras ramas.
- Creación paralela: permite que varios equipos trabajen simultáneamente en diferentes versiones, características o correcciones dentro de sus respectivas ramas de mapas.
- Publicación independiente: Publique la documentación de ramas de mapas individuales sin esperar a que se completen los cambios en otras ramas.
- Combinación controlada: Combine los cambios de una rama de asignación en la rama predeterminada (
main), con la capacidad de revisar y resolver conflictos.
Bifurcación frente a líneas base
Una línea de base identifica una combinación específica de versiones de temas para un mapa DITA, lo que le permite generar resultados utilizando esas versiones seleccionadas.
Una rama proporciona un entorno de edición independiente para un mapa DITA y su contenido, lo que permite a los autores realizar cambios sin afectar a otras ramas del mismo mapa.
Próximas funcionalidades
Actualmente, las siguientes funcionalidades solo son compatibles con la rama predeterminada (main) y se prevé que sean compatibles con otras ramas de un mapa DITA en futuras versiones de Experience Manager Guides:
- Buscar
- Buscar y reemplazar
- Revisar flujos de trabajo