Árvore

A árvore é a estrutura da base, e você a monta com duas coisas: pastas, que agrupam, e documentos, que carregam o texto. Ambas em qualquer profundidade.

O caminho é o endereço

Um documento é endereçado pelo caminho até ele, e esse caminho é legível:

politicas/                      ← pasta
├── devolucao/                  ← pasta
│   ├── prazo                   ← documento  →  politicas/devolucao/prazo
│   └── excecoes                ← documento  →  politicas/devolucao/excecoes
└── garantia                    ← documento  →  politicas/garantia

Esse mesmo caminho é o que o agente usa para ler, o que aparece na barra de endereços quando você abre o documento, e o que fica registrado quando ele embasa uma resposta. Um endereço só, servindo às três coisas.

Renomear ou mover um item o reendereça, junto com tudo o que estiver abaixo dele, o que significa que reorganizar a árvore muda como o agente encontra as coisas. Vale fazer isso com intenção e não por arrumação.

A árvore não para no documento

Aqui está a parte que muda como vale a pena escrever. Um documento não é uma folha da árvore, e sim outro nível dela: os títulos de seção que você escreve viram endereços, e o agente pode descer até um deles em vez de abrir o documento inteiro.

politicas/devolucao/prazo              ← o documento
├── prazo-padrao                       ← uma seção   →  politicas/devolucao/prazo/prazo-padrao
└── produtos-personalizados            ← outra seção →  politicas/devolucao/prazo/produtos-personalizados

A consequência prática é direta: um título de seção é um endereço, e escrever bons títulos é tão estrutural quanto organizar pastas. Um documento longo com seções bem nomeadas serve o agente melhor do que cinco documentos curtos, porque ele desce até o parágrafo que responde sem carregar o resto.

Ordem e nomes

Irmãos aparecem em ordem alfabética, respeitando acentuação e números, de modo que Etapa 2 vem antes de Etapa 10 e pastas não são promovidas para cima dos documentos. Você não arrasta para reordenar, porque quem ordena é o nome.

Dois irmãos não podem ter o mesmo nome. A plataforma recusa a criação nomeando quem já ocupa o endereço, em vez de inventar um sufixo e deixar dois caminhos parecidos disputando a mesma pergunta.

Sobre como nomear, três hábitos resolvem quase tudo:

• Nomeie pelo que é, não pelo que contém, porque prazo acha e informacoes-importantes não.
• Uma pasta por assunto, não por origem, já que quem escreveu o documento não interessa a quem lê.
• Evite profundidade decorativa, porque cada nível a mais é um passo a mais que o agente precisa dar para chegar ao fato.

Vale gastar o mesmo cuidado na descrição de cada pasta e documento. Ela é o que o agente lê enquanto navega, antes de decidir se desce ou se lê, e é a diferença entre ele encontrar o caminho na primeira tentativa ou na terceira.

Mover e excluir

Arrastar um item o leva para dentro de uma pasta ou para a raiz, e arrastar uma pasta leva junto tudo o que está dentro dela. Soltar uma pasta dentro dela mesma, ou dentro de algo que ela contém, é recusado durante o arraste, e a árvore fica como estava.

Excluir uma pasta pede uma confirmação que nomeia o que se perde junto, porque o que se perde junto é sempre a parte de que ninguém lembra.

Achar sem percorrer

A árvore existe para o agente descer nível a nível, mas você não precisa fazer o mesmo: qualquer documento é alcançável pelo nome, sem abrir pasta nenhuma.