Documentação Ágil: Mais conversa, menos escrita

Por que ter documentação em Agile?

Requisitos ágeis e documentação ágil têm um conceito fundamental em comum: Falar mais, escrever menos. O propósito das User Stories é registrar apenas informações suficientes para iniciar conversas futuras sobre uma funcionalidade desejada. A documentação ágil deve ter um objetivo semelhante: Criar apenas a documentação necessária para que seja útil em vez de supérflua.

Documentos só fazem sentido quando são realmente lidos

Ao considerar qual documentação é necessária em um projeto, você deve primeiro pensar em quais documentos foram utilizados regularmente ou nunca neste ou em projetos anteriores. Incentive as discussões que surgem quando a equipe conversa sobre as diferentes possibilidades de documentação. Nessas discussões, frequentemente são expostos documentos que no passado não foram utilizados para seu propósito original ou não foram utilizados de forma alguma.

Todos os documentos que foram utilizados regularmente devem continuar sendo utilizados. Os que não foram utilizados provavelmente não devem mais ser usados (a menos que sejam exigidos por leis ou outras regulamentações). Sobre tudo que estiver no meio-termo, a equipe deve votar ou chegar de outra forma a uma decisão de sim ou não.

Mas não pare por aqui. Para cada documento que continuará sendo utilizado, a equipe deve considerar se não existe uma alternativa onde se fale mais e se escreva menos.

Exemplo de documentação desnecessária

Por exemplo, uma equipe com a qual trabalhei certa vez deveria escrever um chamado "Database Impact Report" para cada alteração realizada. A maioria das alterações, porém, não tinha nenhum impacto no banco de dados, então as 20 perguntas do relatório de cinco páginas eram quase todas respondidas com "sem impacto".

Este documento foi substituído por uma pergunta adicional no Deployment Checklist, que dizia: "As alterações no banco de dados foram consideradas?"

Conclusão

Times ágeis não são fundamentalmente contra documentação. No entanto, eles buscam maneiras de passar de documentos para discussões. Uma possibilidade para isso é procurar alternativas para pelo menos alguns dos documentos existentes.
E isso vai te ajudar a ter sucesso com Agile.

Quer entender melhor o Agile e aprender como ajudar sua equipe da melhor forma? Então participe agora de um Treinamento de Scrum Master e torne-se um Scrum Master certificado em três dias através da Agile Academy.

Este artigo é de Mike Cohn e foi traduzido por nós para o português.