Visão geral
A ramificação no Adobe Experience Manager Guides permite criar e gerenciar várias ramificações fora da ramificação principal para que um mapa DITA funcione em diferentes versões de documentação em paralelo. Cada ramificação permite que os autores gerenciem as alterações de conteúdo de maneira independente, sem afetar o conteúdo correspondente em outras ramificações.
Com a ramificação, várias equipes podem trabalhar simultaneamente em diferentes versões, recursos ou correções associados ao mesmo mapa DITA. Você pode mesclar as alterações de uma ramificação na ramificação padrão (main) quando as atualizações estiverem prontas.
Como a ramificação funciona
Você pode criar uma ramificação a partir da principal ou de qualquer ramificação existente de um mapa DITA. Depois de criar uma ramificação, você pode alternar para ela e começar a editar o mapa e seu conteúdo. Você também pode publicar conteúdo da ramificação selecionada ou mesclar alterações em main quando estiver pronto.
Por exemplo, considere um mapa DITA chamado install-the-lift.ditamap que contém instruções de instalação para um produto. Sua equipe de documentação pode criar duas ramificações deste mapa a partir de main:
- Versão 1: A Equipe A mantém instruções de instalação existentes e endereça correções.
- Versão 2: A equipe B desenvolve instruções de instalação para novos recursos.
Ambas as equipes podem trabalhar de forma independente em suas respectivas ramificações de mapa sem afetar as alterações umas das outras.
Ao criar uma ramificação de um mapa DITA, o Experience Manager Guides não copia automaticamente os tópicos referenciados do mapa para a nova ramificação. Os tópicos inalterados são lidos na ramificação de origem ou na ramificação padrão (principal). Um tópico é copiado na nova ramificação somente quando você o edita e o salva nessa ramificação.
Por exemplo, um mapa DITA faz referência a 100 tópicos, e o repositório contém 50 tópicos adicionais que não são referenciados pelo mapa. Ao criar uma nova ramificação (versão 1.0), todos os 100 tópicos referenciados tornam-se automaticamente parte da versão 1.0, mesmo que nenhum deles seja editado. Os 50 tópicos não referenciados não se tornam automaticamente parte da nova ramificação. Se você editar 10 deles, somente eles se tornarão parte da versão 1.0. Os 40 tópicos restantes inalterados continuam a ser usados na ramificação padrão (principal).
Principais benefícios
Trabalhar com uma ramificação no Experience Manager Guides oferece os seguintes benefícios:
- Edição isolada: Faça alterações em uma ramificação de mapa selecionada sem afetar o conteúdo correspondente em outras ramificações.
- Criação paralela: permite que várias equipes trabalhem simultaneamente em diferentes versões, recursos ou correções em suas respectivas ramificações de mapa.
- Publicação independente: publique a documentação de ramificações de mapa individuais sem esperar que as alterações em outras ramificações sejam concluídas.
- Mesclagem controlada: mescla as alterações de uma ramificação de mapa na ramificação padrão (
main), com a capacidade de revisar e resolver conflitos.
Ramificação versus linhas de base
Uma linha de base identifica uma combinação específica de versões de tópico para um mapa DITA, permitindo gerar saída usando essas versões selecionadas.
Uma ramificação fornece um ambiente de edição separado para um mapa DITA e seu conteúdo, permitindo que os autores façam alterações sem afetar outras ramificações do mesmo mapa.
Futuras funcionalidades
Atualmente, as seguintes funcionalidades são suportadas apenas na ramificação padrão (main) e estão planejadas para serem suportadas em outras ramificações de um mapa DITA em versões futuras do Experience Manager Guides:
- Pesquisar
- Localizar e substituir
- Revisar workflows