Issues e Tasks são as ações que realizam os Épicos. É por meio do registro das Issues que entendemos como será feito!
Veja estas mesmas instruções no vídeo: https://youtu.be/4wQV0eC1zY8
Cadastro inicial da Issue
Instruções para realizar o cadastro inicial de uma Issue:
- Issues e Tasks são cadastradas e mantidas por Coordenador de Linha, Professor Responsável, Pós-graduando ou Lider Técnico da equipe
- Cadastrar as Issues em qualquer projeto que esteja abaixo do grupo "Geral" (https://codigos.ufsc.br/ceos/geral)
- Uma Issue deve ter a duração máxima de 02 semanas. Se a duração inicialmente estimada for maior que 02 semanas a Issue deve ser quebrada em Issues menores
- Título da Issue deve iniciar sempre com verbo no infinitivo (como será feito)
- Deve ser selecionado o Template para descrição da Issue para que sejam carregadas as informações necessárias para o preenchimento da descrição
- A Issue sempre deve ser alocada aos responsáveis. Atribuir ao menos o responsável principal no campo Assignees
- A Issue deve sempre ser associada ao Épico correspondente.
- A Issue deve ser associada ao Milestone correspondente. Se por acaso não existe ainda o Milestone de entrega desta Issue, o campo pode ser temporariamente deixado em branco. Informar o PMO para que o Milestone da entrega seja cadastrado
- Definir o Label da Linha: level::Linha-1 (por exemplo)
- Definir o Label do Projeto: projeto::Fluxos (por exemplo)
- Definir o Label do Tipo: tipo::Desenvolvimento (por exemplo)
Refinamento da Issue
Antes de iniciar uma nova iteração as Issues que serão realizadas naquela Iteração devem ser refinadas (detalhadas). Isso implica em completar a descrição da Issue de forma que seja possível realizá-la.
Instruções para refinar uma Issue:
- Issues devem possuir uma descrição suficientemente detalhada que permita a sua realização
- Na Descrição da Issue devem ser detalhados:
- O que precisa ser feito e a justificativa (obrigatório)
- As Tasks da Issue, que correspondem às ações para realização da Issue. Cada Task deve ter a duração máxima de 01 semana. (obrigatório)
- Nas Referências Técnicas indicar as pessoas que devem ser consultadas em caso de dúvida para cada assunto envolvido nesta atividade (opcional)
- Nos Documentos de Referência incluir links para referências externas de apoio ao desenvolvimento da Issue (opcional)
- Nos Critérios de Aceitação, listar as condições para que esta atividade possa ser considerada concluída. Em outras palavras: em quais testes o resultado desta atividade deve passar para ser considerado pronto. (obrigatório)
- Sempre utilizar o Template de Issue correto para o tipo de Issue
- Definir o Label de status da Issue:
- status::Milestone-Backlog: já entrou em um Milestone
- status::Doing: Tasks já iniciaram
- status::Test: para ser testado
- status::Done: pode ser demonstrado para o cliente
- Se esta Issue depende bloqueia ou pode ser bloqueada por outra Issue, essa relação deve ser indicada no campo Linked Issues. Deve ser informado o caminho completo da Issue relacionada, no formato: ceos/[caminho]/[projeto]#[NUMERO]
- O peso da Issue deve ser indicado no campo Weight. Sugere-se utilizar a sequência de Fibonacci (1, 2, 3, 5, 8, 13, 21) para indicar o tamanho e complexidade desta atividade, quando comparada a outras atividades do mesmo projeto
Checklist para cadastro de uma Issue
Verifique o checklist a seguir, se a Issue que você cadastrou está completa:
Cadastro inicial
-
O título da Issue inicia com um verbo no infinitivo -
A duração estimada da Issue é menor que duas semanas -
O template correto da Issue foi selecionado -
Ao menos um responsável foi atribuído (Assignees) -
O Épico ao qual pertence a Issue foi selecionado -
O Milestone foi selecionado -
O label indicando a Linha foi selecionado -
O label o Projeto foi selecionado
Detalhamento da Issue (refinement)
-
A iteração foi selecionada -
O label de Status foi selecionado -
O label de Tipo foi selecionado -
A estimativa de tamanho foi indicada (Weight) -
Os demais responsáveis e envolvidos foram indicados (Assignees) -
Na Descrição consta o que precisa ser feito e a justificativa -
Na Descrição constam as Tasks da Issue -
Na Descrição constam os Critérios de Aceitação -
Na Descrição constam as Referências Técnicas (opcional) -
Na Descrição constam os Documentos de Referência (opcional) -
O prazo de finalização foi definido (opcional)