Please enable JavaScript.
Coggle requires JavaScript to display documents.
Documentação tradicional / Documentação Ágil - Coggle Diagram
Documentação tradicional / Documentação Ágil
Documentação tradicional ≠ Documentação Ágil ≠ Não documentar
Desenvolvimento Ágil reduz a necessidade de documentação
SW em funcionamento é mais importante que documentação abrangente.
Documentação não é prioridade, mas isso não quer dizer que não seja importante.
Necessidade e desejos do Cliente são mapeados por um Analista
Analistas: Define e documenta o que o SW deve fazer.
Conjunto dessa documentação forma a "Especificação de Requisitos do produto."
Especificação de Requisitos do produto serve como contrato e para comunicar as definições à quem vai desenvolver o produto
Desenvolvimento dividido em etapas sequenciais.
Arquiteto de SW analisa os requisitos.
Define e documenta um desenho para a solução.
Documentação entregue ao desenvolvedor
Efetivamente implementar a solução usando a especificação dos requisitos e o desenho.
Documentação feita para definir o que vai ser desenvolvido antes de desenvolver.
Documentação usada como referência para consulta
Documentação serve para:
Definir e detalhar o que precisa ser feito
Comunicar essas informações
Ter uma referência
Problemas
Documentação como meio principal de comunicação.
Documentação extremamente detalhada e longa gera dificuldade em transmitir detalhes técnicos.
Manter documentação consistente para ser usado como referência durante o desenvolvimento e durante toda a vida útil do produto.
Cada alteração deve ser refletida em todos os artefatos
Ferramentas sofisticadas para manter a rastreabilidade entre os documentos/alterações.
Custo de alteração alto.
Informação inconsistente é inevitavel
Comunicação feita de várias formas, priorizando formas naturais e mais efetivas.
Comunicação informal e direta necessita de algumas precauções
Equipes pequenas
Mesmo espaço físico.
Pequenos Incrementos
P.O (product owner) ou Cliente presente.
Priorizar colaboração com cliente ao invés de negociação de contratos
Código mais Legível
TDD (Desenvolvimento Dirigido a Testes.
Desenhos simples
Refatoração
Quando documentar?
Benefício/Valor > Custo(criar, manter)
Valor para o Cliente
Documentação é resultado, e não insumo.
Histórias de Usuário.
Detalhar + desenvolver (Iteração/Sprint)