Rodrigo Aguas

Manual de instruções: o mal necessário

Estive viajando e por isso fiquei algum tempo sem atualizar, voltei com vários assuntos interessantes a serem discutidos aqui e pretendo melhorar o ritmo das atualizações. Mas nenhuma das duas publicações de hoje (essa e a anterior) vieram das idéias da viagem, então ainda tem muito pela frente. Esse artigo é mais uma indicação de site do que propriamente um artigo, por isso ficou curtinho.

Não conheci até hoje nenhum desenvolvedor que goste de ficar responsável pelo manual de um projeto. A maioria das vezes demanda tempo e bastante trabalho, mas esse tempo deve ser visto como um investimento, já que mais a frente seu cliente não gastará longas horas suas tirando dúvidas que seriam facilmente resolvidas por um manual bem feito. Pior ainda quando seu cliente resolve testar o projeto em pleno feriadão e acha que qualquer dúvida ou dificuldade pode lhe telefonar, você lá na praia ou no cinema tendo que tirar dúvidas dele ou negando a ajuda. Nos dois casos a situação seria bastante desagradável.

Se você está convencido a fazer um esforço e aprimorar seus manuais, aconselho a leitura desse pequeno tutorial de como fazer um tutorial com dicas simples mas muito valiosas. Se tiver outra dica valiosa, compartilhe-a conosco, comente! Abraço!

Deixe seu comentário