E por isso, durante o planejamento, documentar (seguindo a logica que botei no texto) é importante para garantir que o software funcione.

Software funcionando (mantendo escopo, prazo e custo) é o objetivo. A metodologia (e a documentacao é parte dela) é apenas um meio para atingir este fim.

Não são idéias novas, nem minhas, nem tão simples que dê para explicar tudo aqui. Mas são mudanças significativas na maneira de se fazer software, na comunicação com o cliente, na maneira de se cobrar o cliente e muito mais, baseado em algumas premissas:

Apesar da documentação ter valor pro cliente e pra você, o software funcionando tem muito mais valor.

Apesar de processos e ferramentas terem seu valor, pessoas e a interação entre elas têm mais valor.

Apesar de que negociar um contrato tem seu valor, a colaboração de perto com o cliente tem muito mais valor.

Apesar de que seguir um plano pré-determinado tem valor, ter a capacidade de responder rapidamente às mudanças tem muito mais valor.

Organizacao eh bom em todos os niveis… ter o armario em ordem, seus livros arrumados na prateleira, seus CDs catalogados ou os seus arquivos no computador nomeados corretamente… sao pequenas coisas que fazem o dia a dia mais eficiente… principalmente se voce compartilha esses livros, CDs e arquivos com outras pessoas… pode ser o colega do trabalho ou sua esposa… a questao eh… um vez organizado, fica facil p/ todos acharem o que estao procurando…se se no caso voce nao vai poder ficar explicando p/ cada um onde as coisas estao… simplesmente documente.

organizar e documentar eh sim um saco… mas pense em fazer isso por uma causa maior… pelo bem estar de todos.

tem empresa que faz isso na porrada… onde trabalho por exemplo se nao preencher o time sheet semanal o individuo recebe ateh tres advertencias… depois comeca a ter parte do salario descontado… documentar eh bom pra poder combrar bem o cliente tambem.

Abrasss!

###

Sou a favor de documentação. Não gosto de escrevê-la, mas, tendo vivido como fornecedor e como cliente, todos tem a ganhar de uma formalização do trabalho.

Porque o problema que vc descreveu (do cliente mudar de ideia) nao é um problema da documentacao e sim do seu relacionamento com o cliente. E mais, a documentacao (no minimo) ajudaria nesta discussao.

O problema é que o documento substitui a comunicação com o cliente, que escreveu uma regra hoje e quer outra daqui a cinco minutos. A colaboração constante com o cliente, se possível lado a lado, é uma prática quase ausente na criação de software, mas é altamente valiosa porque você consegue feedback instantâneo, coisa que o documento não faz por você.

Como diz aquele ditado, quem guarda o que não presta tem o que precisa!

Mas, tenho que admitir que todas as vezes que precisei levantar alguma informação e recorria a documentação de 1 a 30 preenchida, agradecia pelo processo feito.

A mesma coisa pra um timesheet. Outra porra de coisa chata pra cacete ainda mais pra que trabalha na área de negócios de uma empresa, que faz 900 mil coisas ao mesmo tempo e tem que detalha-las numa planilha. Um saco!

Porém, vendo do ponto de vista da empresa os dois processos são fundamentais.

Um mal necessário para ambas as partes. Funcionários e Proprietários

Eu sou muito a favor de metodologia e documentacao, mas na correria do dia-a-dia algumas dessas coisas vão sendo esquecidas, e o esquecimento vira o padrão. O ideal era fazer tudo na sequencia certa, documentar tudo pra ter tudo organizado e nao esquecer de detalhe nenhum, que tenha que ser acrescentado durante a producao… mas quem disse que no Brasil da tempo?