Criando e editando documentos
Os documentos no AB Projects são páginas em Markdown com histórico de versões completo. A criação e a edição acontecem em um painel lateral com visualização ao vivo, e toda alteração é registrada para que a equipe sempre saiba o que mudou e por quê.
Criando uma página
- Na área Documentos do projeto, inicie uma nova página. Dê a ela um título, um caminho pai opcional (o padrão é
/— defina algo comoonboardingpara aninhá-la) e tags opcionais. - Escreva o corpo em Markdown. O editor mostra uma visualização ao vivo ao lado do código-fonte para que você veja o resultado renderizado à medida que digita.
- Salve para publicar a página na árvore. Ela se torna a versão 1.
Editando uma página
- Abra uma página e escolha Editar (no menu de ações da página). O mesmo painel abre com o Markdown atual.
- Uma nota de edição é obrigatória ao editar. Antes de salvar uma alteração, você precisa inserir uma breve nota descrevendo o que mudou — se deixá-la em branco, o AB Projects pede que você adicione uma "para que sua equipe saiba o que mudou". (Páginas novas não precisam de nota; edições precisam.)
- Salvar cria uma nova versão em vez de sobrescrever — a versão anterior é preservada.
Histórico de versões e restauração
- Toda página acompanha um número de versão e o editor e a hora mais recentes.
- Abra o Histórico no menu de ações da página para ver versões anteriores, cada uma com sua nota de edição — assim o "porquê" de cada alteração fica registrado.
- Você pode restaurar uma versão anterior a partir da lista de histórico. Restaurar traz aquele conteúdo de volta como a página atual (e é registrado como uma nova versão).
Excluindo uma página
- Excluir está disponível no menu de ações da página, deliberadamente posicionado longe de Editar/Histórico para não ser clicado por acidente.
- Excluir remove a página da árvore. Trate isso como uma ação cuidadosa — prefira editar ou restaurar a excluir quando você só precisa alterar o conteúdo.
Dicas
- Use o caminho pai para criar uma estrutura clara (por exemplo
engineering/runbooks) em vez de uma lista plana de páginas. - Escreva notas de edição significativas — é o que o Histórico mostra e o que os colegas usam para entender uma alteração sem comparar diferenças.
- Use a visualização ao vivo para conferir a formatação (títulos, blocos de código, links) antes de salvar.
- Se uma edição deu errado, restaure a versão anterior no Histórico em vez de reescrever de memória.
Com Markdown, visualização ao vivo, notas de edição obrigatórias e histórico completo com restauração, os Documentos continuam fáceis de escrever e seguros de alterar.