Documentação Ágil

1.555 visualizações

Publicada em

Publicada em: Tecnologia
0 comentários
5 gostaram
Estatísticas
Notas
  • Seja o primeiro a comentar

Sem downloads
Visualizações
Visualizações totais
1.555
No SlideShare
0
A partir de incorporações
0
Número de incorporações
8
Ações
Compartilhamentos
0
Downloads
0
Comentários
0
Gostaram
5
Incorporações 0
Nenhuma incorporação

Nenhuma nota no slide

Documentação Ágil

  1. 1. Rodrigo Branas – @rodrigobranas - http://www.agilecode.com.br Documentação Ágil
  2. 2. @rodrigobranas rodrigo.branas@gmail.com http://www.agilecode.com.brFormação AcadêmicaCiências da Computação – UFSCGerenciamento de Projetos - FGVCertificaçõesSCJA, SCJP, SCJD, SCWCD, SCBCD, PMP, MCP e CSM
  3. 3. Rodrigo Branas – rodrigo.branas@gmail.com10 anos de experiência na plataforma Java1000 horas em sala de aulaMais de 50 palestras em eventosLíder da área de desenvolvimento na GenneraAutor da revista Java MagazinePalestranteInstrutor da Academia Java e Agile da GlobalcodeCriador dos treinamentos de Clean Code, Selenium eMaven da Agile CodeTrabalhou com as empresas:EDS, HP, GM, Citibank, OnCast, Globalcode, V.Office, Dígitro, Softplan, Unimed, Suntech, Vale do Rio
  4. 4. Por que documentamos?
  5. 5. Seu processo diz que você deve criar o documento
  6. 6. Alguém acredita que o documento vai garantir o sucesso do projeto
  7. 7. Auditoria
  8. 8. O cliente solicita achando que dessa forma estará no controle
  9. 9. Para especificar o trabalho quedeverá ser realizado por alguém
  10. 10. Para se comunicar com um grupo externo
  11. 11. Para ser arquivado nas memórias da organização
  12. 12. Pontos críticos relacionados com a documentação
  13. 13. Foco na documentação e não na comunicação
  14. 14. Cover Your Ass!
  15. 15. Pressão na equipe
  16. 16. Documentação estática
  17. 17. BDD – Behavior-Driven Development
  18. 18. Entender o TCO (Total Cost of Ownership) do documento
  19. 19. Código bem escrito e testado pode evitar a criação de documentos
  20. 20. O benefício que o documento traz deve ser maior que seu custo
  21. 21. O investimento em documentaçãodeve ser uma decisão de negócio e não técnica
  22. 22. Quais são as características de um documento ágil?
  23. 23. Satisfaz um propósito
  24. 24. É enxuto e suficiente
  25. 25. Descreve situações que tem baixa probabilidade de mudar
  26. 26. Descreve o que não é óbvio
  27. 27. Facilitar o trabalho de alguém
  28. 28. Código-fonte faz parte da documentação?
  29. 29. CRUFT:C = How Correct is the document?R = Will the document be read?U = Will the document be understood?F = Could the document be followed?T = Is the document trusted?
  30. 30. CRUFT:C = How Correct is the document?R = Will the document be read?U = Will the document be understood?F = Could the document be followed?T = Is the document trusted?
  31. 31. CRUFT:C = How Correct is the document?R = Will the document be read?U = Will the document be understood?F = Could the document be followed?T = Is the document trusted?
  32. 32. CRUFT:C = How Correct is the document?R = Will the document be read?U = Will the document be understood?F = Could the document be followed?T = Is the document trusted?
  33. 33. CRUFT:C = How Correct is the document?R = Will the document be read?U = Will the document be understood?F = Could the document be followed?T = Is the document trusted?
  34. 34. CRUFT:C = How Correct is the document?R = Will the document be read?U = Will the document be understood?F = Could the document be followed?T = Is the document trusted?
  35. 35. Práticas recomendadas para documentação
  36. 36. Documente conceitos estáveis, o mais tarde possível
  37. 37. Gere a documentação de formaautomatizada sempre que possível
  38. 38. Busque melhores formas de comunicação
  39. 39. Requisite sempre uma justificativa para os pedidos de documentos

×