Ao invés de perguntar sobre documentação, aprenda com ela

Que tal um Doc Journey Map, como um Customer Journey Map inspirado em 5w2h e SIPOC?

Conforme o porte da empresa, envolvem-se Governança, PMO, área de processos e representantes das equipes, trata-se de uma necessidade e responsabilidade da organização estabelecer alguns padrões e GQA necessário.

Lembra SIPOC, trabalha uma espécie de 5w2h de origem a destino de cada artefato, incluindo uma reflexão sobre custo (empenho), confiabilidade, redundância e validade, quer temporária ou permanente.

Como todos os canvas e artefatos ágeis, são experienciais, o objetivo não é seguir o roteiro, mas estabelecer uma discussão focada em desperdícios e valor, assertiva, da melhor forma possível, caso-a-caso.

Não se preocupe com o número de campos, o preenchimento é orgânico, preencher é fácil e rápido se as pessoas envolvidas estiverem presentes, promovendo um debate não sobre certo e errado, mas uma auto-avaliação, momento e necessidades.

Baixe o canvas acima em tamanho A3

Em startups e pequenas empresas nunca usei, nunca precisou, esta é uma técnica para grandes empresas, quando há áreas de processo, governança e PMO, pois a discussão sobre métodos ágeis sempre envolve também documentação.

Um exercício que pode gerar muita empatia e sinergia, todos buscando potencialmente passar a gerar artefatos com maior conhecimento do processo, o mínimo realmente necessário, considerando origem, destino e relevância.

Eu sempre começo pelo processo, é quase um aquecimento, de forma simplificada, garantindo sempre que seja divertido e descontraído, direto no quadro branco. O resumo é o passo-a-passo da documentação em questão, eu coloco inclusive os nomes da galera.

Artefato – Nome do artefato
GT – Grupo de trabalho
Data – Datas de discussão

Quem cria – papel ou equipe
Onde/como – ferramenta e repositório
Conteúdo/objetivo – informações
Custo/energia – Tempo e envolvimento
Redundância – Único ponto ou não

Quem usa – papel ou equipe
Quando/porque – momento e para que
Valor agregado – qual o seu valor
Validade – temporário ou permanente
Confiabilidade – é confiável, timing

Processo – fluxo simplificado de manipulação desta documentação
Meta/futuro – qual a projeção, melhoria, mudanças, novas práticas, substituição

Não tem um roteiro rígido, mas bom senso, eu uso uma folha para cada artefato utilizado ou proposto, preenchendo com postits pequenos, pelos olhos de quem faz e quem consome … estruturando um mapa de docs na parede, da esquerda para a direita representando tempo.

Uma folha para cada documento ou artefato, entre as pessoas interessadas, em um GT, não impondo certo ou errado, mas provocando uma reflexão e debate sobre cada oportunidade, construção e manutenção, custo x benefício.

No mercado tem uma variedade de artefatos e documentos, alguns bem tradicionais, alguns ágeis, muitos em transição – Visão, análise de negócio, casos de uso, ER, histórias do usuário, product backlog, BDD, protótipos, cenários de testes, …

Não é um autor que vai dizer o que é bom ou não para o momento de vocês, afinal estamos todos em transição, os livros, artigos e debates em fóruns e CoP’s ajudam a ter maior discernimento neste debate sobre o que manter, mudar, abandonar, um passo cada vez.

O campo de meta/futuro é exatamente identificar alternativas futuras para substituição ou mesmo eliminação, quem sabe boas práticas como histórias do usuário, seguindo DDD, partindo de BDD, código auto-documentado e clean code, uma boa orientação a serviços, automação de testes funcionais, etc.

Documentação é inversamente proporcional às suas boas práticas ágeis
Acredite, documentação é muito mais que as tais histórias do usuário