A documentação é uma história de usuário? [fechadas]

13

Precisamos fazer alguma documentação do usuário para um produto em que estivemos trabalhando nos últimos sprints. Agora, estamos iniciando um novo projeto no próximo sprint e o OP está tornando a documentação do produto produzido anteriormente uma história de usuário para esse sprint.

Estou apenas pensando sua opinião sobre essa abordagem. Pessoalmente, não concordo que a documentação seja uma história de usuário no Scrum porque não produz nenhum código.

EDIT: Obrigado por suas opiniões pessoal. Fiquei pensando que um sprint era para implementar um incremento de software em funcionamento, mas seus pontos de vista mudaram minha perspectiva. Obrigado por todas as suas respostas.

código de edição
fonte
você está pensando em criar uma história do usuário para criar a documentação do sistema ou usar uma história do usuário como a documentação do sistema?
Ryathal
Acho que outros já deram a resposta que você procura, mas em geral quase todo trabalho que sua equipe faz é uma história. Embora sejam chamadas de histórias de "usuário", elas podem ser inseridas do ponto de vista (ou necessidade) de qualquer parte interessada de um projeto, o que também inclui você, o desenvolvedor (por exemplo, "Como desenvolvedor, preciso ..... monte de internos .... ")
DXM
2
Se você pode concluir e receber o pagamento por uma história de usuário sem escrever nenhum código, pule sobre isso.
Jeffo
1
@ Jeffff - Eu prefiro escrever código obrigado. Talvez eu possa escrever o código para escrever a documentação ... Uma espécie de máquina Luz Von Neumann: p
SoylentGray

Respostas:

15

"Como usuário do X, preciso saber como o X funciona" parece uma história de usuário legítima para mim. Isso pode resultar em documentação escrita ou ajuda online.

O ponto não é apenas o código - é atender aos requisitos dos usuários.

Matthew Flynn
fonte
6
Operadores, administradores e outras pessoas técnicas são usuários de primeira classe. Eles obtêm histórias de usuários como todos os outros usuários.
S.Lott
10

Idealmente, a documentação faz parte de toda história do usuário e nunca se acumula. Mas, no mundo real, isso geralmente não acontece. Nesse caso, você deve criar uma história de usuário para acompanhar uma parte específica da documentação que está faltando.

Você está certo, não produz nenhum código. Mas ele atende a um requisito do usuário e deve ser priorizado em relação a outros requisitos do usuário.

Se isso significa que nunca é feito, porque essa e aquela funcionalidade estão sendo trabalhadas, provavelmente você não precisava muito da documentação.

pdr
fonte
3
Se a documentação for necessária, eventualmente ela poderá se tornar parte da definição de concluído.
Hugo Hugo
3

Concordo com a avaliação da documentação do pdr se for sobre requisitos, documentação técnica ou de projeto. Idealmente, ele deve ser incorporado ao trabalho de sprint.

A documentação do produto é muito diferente, pois é uma entrega solicitada pelo usuário real e fornece diretamente valor ao usuário. É claro que isso deve ser entendido que a documentação do produto não é essencialmente uma tarefa técnica, mas uma tarefa funcional e pode ou não ser uma atividade adequada para um recurso técnico do projeto.

Eu acho que deveria ser uma história de usuário, no entanto, acho que um recurso de projeto que tenha um entendimento firme dos requisitos de negócios, perspectiva do usuário e boas habilidades de redação técnica deve receber essas tarefas. Idealmente, esse seria um analista de negócios, se houver algum disponível, ou talvez um testador de controle de qualidade de ordem superior, com um entendimento firme dos requisitos, histórias do usuário e boas habilidades de redação técnica. Isso também pode ser um desenvolvedor, no entanto, a documentação do produto escrita pelos desenvolvedores tende a não ser tão alta qualidade ou tão útil, porque os desenvolvedores geralmente estão muito próximos dos detalhes técnicos.

maple_shaft
fonte
1

Em nossa organização, a equipe de ferramentas, encarregada de manter e aprimorar nosso sistema de integração contínua, está usando o Scrum para ajudá-los a gerenciar seu trabalho. Eles não estão escrevendo código, mas estão praticando o Scrum.

Para responder sua pergunta especificamente, eu perguntaria se a equipe considera que a documentação faz parte da "Definição de Concluído" ou não.

Se a equipe considerar que a documentação faz parte da "definição de concluído", não há necessidade de uma história adicional e a história não poderá ser aceita, a menos que a documentação seja escrita e validada.

Se a equipe considerar que a documentação não faz parte da "definição de concluído", eu criaria uma história separada para que o Dono do Produto possa gerenciar seu trabalho.

David Segonds
fonte