It is sometimes said (particularly by undergraduates)
that the details of technical writing
are beneath the notice of a scientist of any worth.
The implied contrapositive,
that scientists who are concerned with such details
are not first rate,
has obvious counterexamples.
It is the belief of a non-trivial subset of our community,
including Knuth
(Mathematical Writing, Stanford University, 1988),
that writing skills
are a necessary part
of the training of a scientist.
—Ian Parberry,
A Guide for New Referees in Theoretical Computer Science,
SIGACT News, 1989
Todo texto (artigo de jornal, relatório, programa de computador) tem um conteúdo e uma forma. É claro que estamos muito mais interessados no conteúdo que na forma. É claro que estamos muito mais interessados n'o que o texto diz de que em como o texto diz o que diz. Conclusão: a forma não é importante; a escolha de palavras apropriadas, o respeito às convenções gramaticais e tipográficas, tudo isso é bobagem. Certo?
Errado. Toda vez que desrespeita uma regra de gramática, usa uma palavra inadequada ou atropela uma convenção tipográfica, o autor atrai a atenção do leitor para a forma. Toda vez que arranha a forma, o autor impede que o leitor concentre sua atenção no conteúdo. Por isso, e só por isso, uma boa forma é tão importante.
Quanto melhor a forma, mais ela é transparente e imperceptível. Quanto melhor a forma, mais fácil é concentrar a atenção no conteúdo. Quanto melhor a forma, mais ela é transparente e imperceptível.
A forma de um texto é a janela através da qual o leitor vê o conteúdo. Se o vidro da janela está limpo, ele é invisível e permite que o leitor concentre sua atenção no conteúdo. Se o vidro está sujo, o leitor percebe sua existência e tem dificuldade em concentrar a atenção no conteúdo.
A seguinte história serve para ilustrar essas idéias. Antonio oferece um copo de leite a José:
— Você vai gostar desse leite, José. Fresquinho. Direto da fazenda do meu avô.
— Mas esse copo está sujo…
— Pare de prestar atenção no copo, Zé! O leite é excelente!
— Mas o copo está sujo por dentro…
— Eu sei que está sujo. Mas o copo não importa. Eu estou falando do leite!
Quem dos dois está certo? Antonio cometeu o erro de desviar a atenção do José do leite para o copo. Se tivesse usado um copo limpo, o José nem notaria que o leite estava dentro de um copo.
Moral: A forma é secundária; o importante é o conteúdo. Mas uma forma defeituosa distrai a atenção que deveria estar concentrada no conteúdo.