Rodrigo Branas é um especialista em Java com mais de 10 anos de experiência e certificações como PMP, MCP e CSM. Ele trabalhou em grandes empresas como EDS, HP e Citibank e atualmente é instrutor na Academia Java e Agile da Globalcode.

1. Rodrigo Branas – @rodrigobranas - http://www.agilecode.com.br
Documentação Ágil

3. @rodrigobranas
rodrigo.branas@gmail.com
http://www.agilecode.com.br
Formação Acadêmica
Ciências da Computação – UFSC
Gerenciamento de Projetos - FGV
Certificações
SCJA, SCJP, SCJD, SCWCD, SCBCD, PMP, MCP e CSM

4. Rodrigo Branas – rodrigo.branas@gmail.com
10 anos de experiência na plataforma Java
1000 horas em sala de aula
Mais de 50 palestras em eventos
Líder da área de desenvolvimento na Gennera
Autor da revista Java Magazine
Palestrante
Instrutor da Academia Java e Agile da Globalcode
Criador dos treinamentos de Clean Code, Selenium e
Maven da Agile Code
Trabalhou com as empresas:
EDS, HP, GM, Citibank, OnCast, Globalcode, V.Office, Dígitr
o, Softplan, Unimed, Suntech, Vale do Rio

5. Por que documentamos?

6. Seu processo diz que você deve
criar o documento

7. Alguém acredita que o documento
vai garantir o sucesso do projeto

8. Auditoria

9. O cliente solicita achando que dessa
forma estará no controle

10. Para especificar o trabalho que
deverá ser realizado por alguém

11. Para se comunicar com um grupo
externo

12. Para ser arquivado nas memórias
da organização

13. Pontos críticos relacionados com a
documentação

14. Foco na documentação e não na
comunicação

15. Cover Your Ass!

16. Pressão na equipe

17. Documentação estática

18. BDD – Behavior-Driven
Development

19. Entender o TCO (Total Cost of
Ownership) do documento

20. Código bem escrito e testado pode
evitar a criação de documentos

21. O benefício que o documento traz
deve ser maior que seu custo

22. O investimento em documentação
deve ser uma decisão de negócio e
não técnica

23. Quais são as características de um
documento ágil?

24. Satisfaz um propósito

25. É enxuto e suficiente

26. Descreve situações que tem baixa
probabilidade de mudar

27. Descreve o que não é óbvio

28. Facilitar o trabalho de alguém

29. Código-fonte faz parte da
documentação?

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. 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?

36. Práticas recomendadas para
documentação

37. Documente conceitos estáveis, o
mais tarde possível

38. Gere a documentação de forma
automatizada sempre que possível

39. Busque melhores formas de
comunicação

40. Requisite sempre uma justificativa
para os pedidos de documentos