Relação entre Metodologias Ágeis e Documentação de Software

Introdução

• Comum ouvir que projetos ágeis não têm documentação.
• "Ágil" usado como desculpa para não documentar.
• Manifesto Ágil: software em funcionamento mais importante que documentação abrangente.
• Metodologias ágeis não são contra documentação.

Documentação em Projetos Tradicionais

• Papel da Documentação:
  • Mapeia necessidades e desejos do cliente.
  • Forma a especificação de requisitos do produto.
  • Age como contrato entre cliente e desenvolvedor.
• Problemas:
  • Documentação usada como principal meio de comunicação.
  • Dificuldade em comunicar detalhes técnicos de forma escrita.
  • Manter documentação consistente é difícil e caro.
  • Alterações nos requisitos aumentam a complexidade.

Abordagem Ágil

• Comunicação Direta:
  • Comunicação verbal preferida em pequenas equipes.
  • Pequenos incrementos no desenvolvimento facilitam a comunicação sem documentação extensa.
• Colaboração com o Cliente:
  • Priorização da colaboração em vez de contratos.
  • Código mais legível e autodocumentado reduz necessidade de documentação.

Quando Documentar em Ágil

• Documentação ocorre quando o benefício supera o custo.
• Não é necessário manter todos os documentos criados.
• Documentação prática e útil para o cliente.

Exemplo: Desenvolvimento Sob Encomenda

• Cliente quer documentação para manutenção futura.
• Documentação preparada como um resultado, não insumo, do desenvolvimento.
• Histórias de usuário como identificadores simples de itens a serem desenvolvidos.

Conclusão

• Reducão de Documentação:
  • Desenvolvimento ágil reduz necessidade de documentação.
• Valor Justificado:
  • Apenas documenta-se quando gera valor suficiente.
• Documentação como Resultado:
  • Documentação tratada como resultado do projeto ágil, não como insumo.