Dois leitores estavam escondidos em cada nota de status que eu escrevia

Três dias depois, dei de cara com um comentário que eu mesmo tinha deixado e não consegui ler. Eu me lembrava de ter escrito. Mesmo assim, precisei parar, ir mais devagar e decifrar como se fosse de outra pessoa (Ler em inglês).

Foi esse o sinal. Se quem escreveu a frase não consegue entendê-la de cabeça fria, ninguém que leia depois tinha chance.

Dois leitores, e eu escrevia para os dois ao mesmo tempo

Toda nota que escrevo tem um leitor real em mente, e ele é sempre de um de dois tipos. Ou é uma pessoa dando uma olhada rápida para saber como as coisas estão, ou é um sistema que vai agir depois com base nos detalhes exatos e precisa do valor preciso, não de uma paráfrase. O erro foi escrever como se os dois quisessem a mesma coisa. Uma pessoa quer três segundos e uma frase simples. Um sistema quer o número exato, porque vai usar esse número, e não apenas concordar com a cabeça.

Depois que percebi isso naquele comentário, passei a ver o mesmo em todo lugar. Notas que deveriam ser uma atualização rápida de status estavam cheias de detalhes precisos que só um sistema precisaria para agir. Cada uma era feita para uma leitura humana rápida e foi se enchendo aos poucos do tipo errado de conteúdo, porque escrever para os dois ao mesmo tempo parecia eficiente na hora.

Não era eficiente. Custava o dobro. A pessoa tinha que tirar o detalhe técnico de cabeça para entender o essencial. E misturar valores exatos num texto corrido é um bom jeito de perdê-los ou de embaralhá-los no caminho.

Escolher o leitor primeiro

A solução foi decidir, antes de digitar qualquer coisa, de quem é aquela superfície em particular, e manter os dois tipos de escrita separados daí em diante. Uma atualização de status que uma pessoa vai ler por cima é escrita de modo que alguém sem familiaridade com os detalhes consiga acompanhar numa só leitura, sem precisar consultar nada. Tudo o que um sistema precisa para agir com precisão, como um número exato ou uma configuração específica, vai para um lugar feito para isso.

O detalhe exato nunca desaparece. Ele vai para o lugar feito para o leitor que precisa dele, em vez de ficar na nota destinada a quem passa o olho em três segundos.

A parte que ninguém automatizou

Uma pessoa ainda decide qual superfície é para leitura rápida e qual é para valores exatos, e essa decisão precisa acontecer antes de qualquer coisa ser escrita, não depois que algo se mostra ilegível. O que dá para automatizar é encontrar os casos mistos e limpá-los, uma vez que os dois tipos foram separados. Decidir onde fica essa linha continua sendo uma escolha humana, sempre.

Antes de escrever uma nota de status, decida para quem ela é: alguém que quer uma resposta rápida, ou algo que vai agir com precisão sobre o que você escreveu. Depois releia de cabeça fria, alguns dias mais tarde. Se você precisar parar para decifrar, todo mundo depois de você também vai precisar.