Guardar as suas decisões13 / 20
Rever todas as versões
Nesta página
Cada mudança num Documento de Intenção é guardada. Escolha uma versão para ver quais documentos ela alterou e o que mudou em cada um, se você fez a edição ou se o Agent propôs e você aceitou, e como o texto foi explicado na época. Como você chegou a cada decisão continua tudo lá.
Abra o histórico de versões
Há três caminhos:
- Passe o cursor sobre o título “Intenções” na barra lateral e clique no botão de histórico.
- Escolha Visualizar → Histórico de versões, ou pressione
⌘Y(Ctrl+Yno Windows e no Linux). - Numa nota que diz “Isto explica o texto anterior”, clique em “Ver no histórico de versões”.
Os dois primeiros só trocam a barra lateral e selecionam a versão mais recente; a área principal fica como está. O terceiro seleciona a versão mais recente que alterou este documento e substitui, no próprio lugar, o documento atual por aquela versão dele.
Enquanto você está no histórico, abas, layouts lado a lado, o painel de código e as conversas da área principal funcionam normalmente. Clique em “Sair do histórico de versões” no topo da barra lateral para voltar à barra lateral normal; a aba do histórico se fecha junto.
De onde vêm as versões
Cada mudança nos seus Documentos de Intenção é uma versão. Por origem, são:
| Origem | Título na lista |
|---|---|
| Você aceitou uma proposta | O título da proposta, como “Enviar e-mail ao dono da equipe quando o período de carência começar” |
| Você aceitou um plano de organização | Organizado |
| Você salvou no Noea ou alterou os arquivos fora do Noea | Edições manuais. Edições manuais consecutivas se unem numa só versão até o próximo Explain terminar |
| Todos os documentos alterados voltaram a um estado já registrado | Voltar a «título dessa versão» |
| Os documentos como estavam quando o registro começou | Início do registro |
Leia a lista de versões
No histórico, a parte de baixo da barra lateral vira a lista de versões, agrupada por dia, com a mais recente primeiro. Cada versão ocupa duas linhas: o título e depois o horário, um ícone de status, um ícone de origem e quantos documentos ela alterou, como “2 documentos”.
- Horário: uma versão de edições manuais mostra o intervalo da primeira à última edição, marcado “Em andamento” até ela se fechar.
- Status: explicada, em investigação ou ainda sem explicação, isto é, se o texto desta versão tem as explicações; passe o cursor para ver quais.
- Origem: distingue as suas edições das do Agent; voltar a uma versão anterior tem o próprio ícone.
A parte de cima da barra lateral continua sendo a árvore de documentos, aninhada e expandida como antes. Os documentos que a versão selecionada alterou ficam marcados:
| Mudança | Marca |
|---|---|
| Criado | Um ponto verde ao lado do nome |
| Modificado | Um ponto amarelo ao lado do nome |
| Apagado | Listado onde estava por último, riscado em vermelho e esmaecido |
| Renomeado | O novo nome, com o antigo esmaecido ao lado |
Abra um documento como ele era
Selecione uma versão e clique num documento da árvore; a área principal o abre como era naquela versão. Um documento do histórico é somente leitura, com um cadeado ao lado do título que diz qual versão é quando você passa o cursor; o layout, a estrutura, a busca e as notas funcionam normalmente, e você pode selecionar e copiar o texto.
O documento marca o que esta versão mudou em relação à anterior, no estilo do modo de revisão: acrescentado, reescrito e apagado, com os parágrafos apagados deixados no lugar. Você pode percorrê-los na parte de baixo.
Se esta versão não alterou o documento, você vê o conteúdo dele como estava na última alteração anterior, com o horário de origem. Se o documento ainda não existia nesta versão, ou esta versão o apagou, isso também é dito.
Quando você seleciona outra versão, um documento do histórico aberto a acompanha, mostrando o mesmo documento como era naquela versão. Uma janela tem uma aba de histórico por vez.
Veja as explicações da época
Cada parágrafo de um documento do histórico mostra a explicação para o texto daquela versão. Se o parágrafo foi reescrito ou apagado depois, a nota dele abre com “Isto explica o texto desta versão”: ela explica o texto como era na época, não o documento como está agora. Os parágrafos que esta versão não explicou aparecem marcados como ainda sem explicação, e os que estão em investigação, como em investigação.
Isso permite responder a “por que foi implementado assim naquela época?”. Por exemplo, quando a proposta do período de carência foi aceita, três semanas atrás, a explicação dela listava a escolha de contar 7 dias como 168 horas; só depois isso foi mudado para dias corridos no fuso horário da equipe.
Se você quiser uma versão anterior de volta
O histórico de versões serve para olhar para trás; não há “restaurar esta versão”. Para trazer algo de volta, copie o texto do documento do histórico, cole no documento atual e salve; ou peça ao Agent, numa conversa, que redija uma proposta que mude um parágrafo de volta para a redação anterior, e aceite depois de revisar.
Se você mantém a pasta de intenção no Git, também pode restaurar os arquivos com o Git. Quando todos os documentos voltam a um estado registrado, a lista de versões mostra uma entrada com o título «Voltar a …».