Texto de 1997

Abaixo reproduzo um texto que criei em 1997, nunca publicado (junto com vários outros que, talvez, eu coloque também neste “blog”).

Foi uma série de materiais que escreví inspirado na minha área profissional (Tecnologia da Informação, na época chamada de Computação), as dificuldades, problemas, casos e situações de quem trabalha nesta área.

Apesar de já ter 12 anos, me parece mais atual do que nunca.

Neste artigo vou demonstrar algumas regras simples e básicas para a correta confecção de Manuais, este maravilhoso instrumento de aprendizado e esclarecimento que ninguém do ramo usa, o que, por conseqüência, ajudará na compreensão dos mesmos quando de sua não utilização.

Seguem, pois, os 10 Mandamentos para a Criação de Manuais de Informática:

1. Use pelo menos 20 termos técnicos obscuros nas três primeiras páginas do manual para imediatamente desencorajar ao usuário;

2. Faça o manual o mais volumoso possível para que o leitor adie indefinidamente o seu uso;

3. Considere sempre que os leitores sejam "experts" em todos os aspectos de processamento de dados;

4. Coloque, deliberadamente, inconsistências e redundâncias por todo o manual para apurar o senso crítico dos usuários;

5. Pelo menos uma vez em cada página faça o leitor ter que consultar outra página, que, por sua vez, demanda consulta a outra, e assim por diante;

6. Se você incluir explicações detalhadas de mensagens de erro garanta não incluí-las todas. Também, deixe algumas páginas totalmente em branco, de forma aleatória. Isto criará um saudável clima de suspense;

7. Duas semanas após a data de publicação envie aos usuários um pacote com "novas páginas a inserir". Envie novos pacotes a cada mês. Desta forma você terá certeza de que cada usuário terá uma versão própria individualizada;

8. Publique o manual em formato inconveniente, com uma capa que em nada lembre o seu conteúdo, para que possa ser fàcilmente perdido em alguma mesa e, preferencialmente, que ao ser aberto esparrame todas as suas folhas pelo chão;

9. Não faça distinção entre palavras-chave e constantes. Não indique quando e/ou como o usuário deve tomar certas precauções. Deixe-o o mais perdido possível. Não se comprometa pois isto pode reverter como críticas de imprecisão;

10. Siga estas instruções e você terá conseguido criar uma obra-prima, um clássico do gênero.

Tenho certeza que a partir do conhecimento destas normas utilizadas por todos os fornecedores, não apenas aqueles restritos ao campo da informática, ficará mais fácil compreender a utilização e programação de triviais aparelhos utilizados no dia-a-dia, tais como video-cassetes, fornos à micro-ondas, CD-players, secretárias eletrônicas e computadores Plug&Play.