Escrevo para não esquecer

Giro muitos projetos ao mesmo tempo e é difícil lembrar-me de todos. Por isso documento: para perceber depois as decisões que tomei. Com a documentação não perco tempo; tenho à mão tudo o que preciso para explicar a mim mesmo o que fiz na altura.

O que documento no meu próprio site

Este site tem a sua própria documentação, e uso-a sempre que mexo em alguma coisa:

• Um manual de marca com a ideia do corte, o tom, o logo, a cor, a tipografia e as regras de cada componente.
• Um guia por componente, com um exemplo que funciona, para saber que peça usar ao construir algo novo.
• Um plano de melhorias com as fases do trabalho e as decisões tomadas, cada uma com a sua data.
• Um resumo de resultados com as medições de antes e depois, de onde saiu a tabela de O site que mede a velocidade.
• Instruções para a IA: como trabalhar no projeto, em que línguas e passo a passo.

Escrevo para quatro leitores

Para mim. Não quero depender da minha memória. Se precisar de fazer mudanças, tenho de saber onde estou.

Para os meus colaboradores. Um negócio só é um negócio se se puder delegar, e só se pode delegar o que está escrito. Comecei a Drakkar, a agência que dirijo, precisamente porque precisava de delegar para crescer.

Para os meus clientes. O projeto é deles, e têm de saber o que foi feito. Por isso entrego-lhes documentação e tutoriais que lhes permitem resolver as coisas sozinhos.

Para a IA. É a minha ferramenta principal, e tem de ter claro o que deve fazer. Isso só se consegue com documentação.

O que pus de parte, também

O plano de melhorias guarda cada decisão com a sua data. Serve-me para saber se, em algum momento, me surge uma ideia repetida, e para me lembrar também do que pus de parte e porquê.

A IA deixa de inventar

A diferença nota-se. Quando lhe entrego documentação, a IA deixa de inventar e passa a agir: toma decisões segundo o meu critério, não segundo a média do que já viu. Noto-o no que produz.

Um exemplo deste site: o manual proíbe frases que qualquer um poderia assinar, como «produtos que fazem a diferença». Com essa regra por escrito, a IA assinala-as e reescreve-as em vez de as propor. Sem o manual, são precisamente as que aparecem primeiro.

Se só pudesse documentar duas coisas

Documente o design system e a arquitetura do projeto: como se vê e como está construído. Com isso, qualquer pessoa, incluindo você daqui a um ano, pode continuar sem começar do zero.

Foi assim que nasceu o design system deste site: eu ponho o critério e deixo-o por escrito, e a documentação leva-o a cada peça.