Ângulo

Um glossário de projeto não tem a função de um dicionário: ele não enuncia o que uma palavra quer dizer em geral, ele fixa o que ela quer dizer aqui, para esta equipe e para as decisões que ela precisa tomar. Sinal do cliente não tem um sentido verdadeiro que Vendas, Suporte e Produto desconheceriam; ele tem um sentido acordado, e é o fato de acordá-lo que faz as quatro funções trabalharem sobre o mesmo objeto. Todo o resto decorre dessa localidade: a entrada é curta porque serve para usar a palavra e não para esgotar o conceito; ela nomeia os vizinhos — messaging, tagline, proposta de valor — porque um sentido só se fixa contra aqueles que o cercam; ela não vale nada fora do contexto que a produziu, e é exatamente por isso que vale algo dentro dele. Uma coleção de definições gerais e corretas não falha em ser exata: ela falha em decidir o que quer que seja.

Síntese

Tomadas separadamente, essas notas resolvem cada uma uma questão de escrita: como separar uma palavra de uma proposição, quando parar, o que escrever primeiro, em que momento abrir um glossário, o que quebra quando não há um.

Juntas, elas dizem outra coisa. A brevidade, a seção das confusões, o limiar dos vários leitores e a fragilidade dos links não são cinco regras independentes: são cinco consequências da mesma escolha de definir apenas localmente. Uma entrada é curta porque visa um uso preciso e não um conceito. Os vizinhos são nomeados porque, num contexto dado, uma fronteira decide onde uma essência não diria nada. O limiar dos vários leitores é aquele a partir do qual um contexto deixa de ser compartilhado tacitamente. E um link entre duas notas só transporta sentido se as duas palavras que ele aproxima estiverem fixadas no mesmo contexto — uma palavra definida em geral deixa o link exatamente tão vago quanto uma palavra não definida.

É isso que separa a infraestrutura documental da ferramenta de precisão coletiva, ainda que as duas produzam textos parecidos. A segunda se reconhece pelo que recusa: a definição verdadeira em todo lugar.

Tensões / contradições

A localidade tem um avesso que essas notas não resolvem: um sentido fixado para uma equipe vira obstáculo assim que é preciso confrontá-lo com o de um parceiro, de um cliente ou de uma fonte externa. O glossário que facilita a tradução dos conceitos de uma fonte para a linguagem do projeto é também o que instala um dialeto.

Tensão interna também entre dois conselhos da mesma família: estabilizar cedo revela os desacordos a baixo custo, mas congelar o sentido de uma palavra antes de a escolha que ela carrega ter sido feita fabrica um acordo sobre a palavra no lugar da escolha.

Questões

• Um glossário local deve declarar as acepções externas que descarta, ou esse levantamento o empurra de volta para o dicionário que ele se recusa a ser?
• Como reconhecer que um contexto mudou a ponto de os sentidos fixados ontem não valerem mais, se nada nas entradas indica isso?