CONHEÇA A FERRAMENTA TUTORIAIS SCRUMHALF SOBRE A GPE FAQ SCRUM

WEBINAR SCRUM TREINAMENTOS

A importância da documentação
Posts mais lidos

10 Posts Mais Lidos em

Publicado em janeiro 29, 2013 por Igor Araujo, membro Equipe Desenvolvimento, GPE 2013 Sobre Agilidade
Ltda. em Scrum, Técnicas ágeis posted on janeir o 2 , 2 0 1 4

4 Dicas de Análise do
Gráfico de Burnup
posted on janeir o 8 , 2 0 1 4

TREINAMENTOS
posted on maio 2 8 , 2 0 1 2

10 fatores para você

descobrir o que te
motiva
posted on setembr o 1 1 ,
2013

User Stories – O que

são? Como Usar?
posted on outubr o 1 0 , 2 0 1 1
(http://blog.myscrumhalf.com/2013/01/a-importancia-da-documentacao/id-
10070290/)Uma das questões que sempre me fiz desde que comecei a trabalhar com
Scrum (http://www.scrumhalf.com.br) foi sobre a importância da documentação.
Sabemos que o Scrum (http://www.scrumhalf.com.br) prega a entrega contínua de valor Idioma
para o cliente. Porém, nem sempre o cliente enxerga a documentação do software que
está sendo desenvolvido como algo de valor. No post de hoje, falo um pouco sobre a Português
importância da documentação em projetos Scrum e sobre como incluir essa tarefa nas English
Sprints sem deixar de entregar valor para o cliente.

Por que documentar?

Arquivo
A metodologia Scrum (http://www.scrumhalf.com.br) é muito usada em projetos de
escopo aberto ou onde exista incerteza sobre o que se quer do projeto. Nestes cenários ► 2014 (2)
as regras podem variar a cada Sprint, o que para muitos pode ser uma grande razão para
não fazer documentação, pois teríamos muito trabalho jogado fora. Entretanto, ressalto ► 2013 (49)
que este tipo de cenário talvez seja onde a equipe mais vai precisar de documentos que
descrevam o produto em desenvolvimento. Pois é neste ambiente que a equipe encontra ► 2012 (117)
mais dificuldade de ter sempre em mente o conhecimento sobre regras e características
► 2011 (103)
do produto, que variam muito.

Recentemente passamos por uma situação em que o cliente entrou em contato ► 2010 (1)
perguntando sobre um determinado comportamento do sistema, no qual ele atua como
PO. Prontamente dissemos a ele: “Iremos verificar e já lhe damos um retorno!”. É nesse
momento que acho que ter uma docu mentação ajudaria muito e pouparia tempo. Pois,
pela falta de uma documentação precisamos acessar o código-fonte, ler algoritmos, ler sqls, Quer ficar por dentro do
etc para então ter um entendimento do comportamento do sistema na situação descrita que aparecer por aqui?
pelo PO. Vejam que se tivéssemos uma documentação, este entendimento Assine nosso feed!
provavelmente seria alcançado mais rápido, pois no lugar de sqls e código-fonte, leríamos
algum texto, ou diagrama, o que tornaria o entendimento mais imediato. Sem contar que
o próprio PO poderia ter acesso à documentação e poderia sanar algumas dúvidas com Seu email:
mais independência.
 Mas não só o PO tem dúvidas sobre o produto. A equipe de desenvolvimento por vezes
também passa pela dificuldade de entender como determinada parte do sistema funciona.
Muitas vezes precisamos destas informações na hora de estimar uma história, por exemplo. Inscrever

Como incluir a documentação nas Sprints

Incluir histórias de documentação em uma Sprint não é uma tarefa muito fácil, pois nem
sempre o PO dará prioridade a estas histórias. Uma forma de documentar sem deixar de
entregar valor é incluir nas histórias da Sprint pequenas tarefas de documentação, de Sobre o que estamos
Dê sua opinião

forma que esta seja feita de forma incremental e vá crescendo ao longo das Sprints. Essas falando…
tarefas pode ser um item de um “Checklist” executado ao final de cada história. No projeto
em que participo atualmente como desenvolvedor, temos, a cada história, uma tarefa para Adaptação Agile
checar a atualização do arquivo de versão, atualização/criação do javadoc, atualização dos
scripts de banco de dados e atualização/criação de testes automatizados. Podemos incluir Agilidade Daily Scrum
nesta tarefa a criação/atualização da documentação. Creio que o ideal seja que as tarefas Desenvolvimento
de documentação tenha relação com sua respectiva história. É claro que quando vamos
Desenvolvimento
iniciar a documentação de um produto que já está a um tempo sendo desenvolvido, isso é
mais difícil. Mas fazendo desta forma, a equipe consegue ao longo das Sprints gerar um Ágil Design Dificuldades
material que cubra todo ou quase todo o produto em desenvolvimento.
Scrum Equipe
Neste post busquei ressaltar a importância da documentação e mostrar uma forma de fazê-
Estimativa FAQ SCRUM
la sem prejudicar a entrega de valor para o PO ao final das Sprints. Vimos que a
documentação pode ajudar muito o trabalho diário do PO e da própria equipe de Ferramenta Gestão Foco

desenvolvimento. História Inspeção

Métodos Ágeis
E você? Faz documentação do seu projeto? Como inclui tarefas de documentação no seu
projeto? Manifesto Ágil
Novidade ScrumHalf Papéis
Até o próximo post!
Planejamento Planning
Poker Pontos de História
Posts relacionados
Princípios Manifesto
Ágil Processo Product
Backlog Product
Owner Projeto Projeto
Ágil Qualidade

Medição de Time Box no 5 dicas para a Evolução de

Retrospectiva Revisão

Scrum
software e Scrum, Scrum gestão de Bancos de Dados
uma dupla de conhecimento da em Projetos Ágeis
sucesso? sua equipe
ScrumHalf
Scrum Master Sprint
Story Point Sucesso
Projetos tarefa Testes
Transparência Treinamento
4º Princípio do Práticas Ágeis de Scrum Tutorial valor Valor
Manifesto Ágil – Projeto
Negócio e Agregado Velocidade
Desenvolvedores
Juntos
Zemanta

Curtir 20 17 10 0 0
0

Tags: documentação

Sem comentários

« Definição de pronto e prepar... Boas práticas de depuração »