Your SlideShare is downloading. ×
0
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Documentação Ágil
Upcoming SlideShare
Loading in...5
×

Thanks for flagging this SlideShare!

Oops! An error has occurred.

×
Saving this for later? Get the SlideShare app to save on your phone or tablet. Read anywhere, anytime – even offline.
Text the download link to your phone
Standard text messaging rates apply

Documentação Ágil

1,056

Published on

Published in: Technology
0 Comments
3 Likes
Statistics
Notes
  • Be the first to comment

No Downloads
Views
Total Views
1,056
On Slideshare
0
From Embeds
0
Number of Embeds
2
Actions
Shares
0
Downloads
0
Comments
0
Likes
3
Embeds 0
No embeds

Report content
Flagged as inappropriate Flag as inappropriate
Flag as inappropriate

Select your reason for flagging this presentation as inappropriate.

Cancel
No notes for slide

Transcript

  • 1. Rodrigo Branas – @rodrigobranas - http://www.agilecode.com.br Documentação Ágil
  • 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. 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. Por que documentamos?
  • 5. Seu processo diz que você deve criar o documento
  • 6. Alguém acredita que o documento vai garantir o sucesso do projeto
  • 7. Auditoria
  • 8. O cliente solicita achando que dessa forma estará no controle
  • 9. Para especificar o trabalho quedeverá ser realizado por alguém
  • 10. Para se comunicar com um grupo externo
  • 11. Para ser arquivado nas memórias da organização
  • 12. Pontos críticos relacionados com a documentação
  • 13. Foco na documentação e não na comunicação
  • 14. Cover Your Ass!
  • 15. Pressão na equipe
  • 16. Documentação estática
  • 17. BDD – Behavior-Driven Development
  • 18. Entender o TCO (Total Cost of Ownership) do documento
  • 19. Código bem escrito e testado pode evitar a criação de documentos
  • 20. O benefício que o documento traz deve ser maior que seu custo
  • 21. O investimento em documentaçãodeve ser uma decisão de negócio e não técnica
  • 22. Quais são as características de um documento ágil?
  • 23. Satisfaz um propósito
  • 24. É enxuto e suficiente
  • 25. Descreve situações que tem baixa probabilidade de mudar
  • 26. Descreve o que não é óbvio
  • 27. Facilitar o trabalho de alguém
  • 28. Código-fonte faz parte da documentação?
  • 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. 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. 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. 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. 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. 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. Práticas recomendadas para documentação
  • 36. Documente conceitos estáveis, o mais tarde possível
  • 37. Gere a documentação de formaautomatizada sempre que possível
  • 38. Busque melhores formas de comunicação
  • 39. Requisite sempre uma justificativa para os pedidos de documentos

×