# Política de Issues
# Histórico de versões
Data | Autor | Descrição | Versão |
---|---|---|---|
29/08/20 | Lucas Midlhey(Lucas Midlhey) | Criação do documento | 0.1 |
29/08/20 | Lucas Midlhey(Lucas Midlhey) | Primeira versao com referencias | 1.0 |
# Padrão de Issue
As issues são uma maneira de manter um controle de tarefas, melhorias e bugs para projetos. Elas ajudam a mitigar o risco de trabalho duplicado e um meio de comunicação com contribuidores.
# Criar Issue
- Toda tarefa executada no projeto deve ser referente a uma issue
- O nome e conteúdo da issue deve ser escrito em português
- O nome definido para cada issue deve começar com um verbo no infinitivo
- O nome da issue deve ser significativo e o mais breve possível
- Toda issue deve possuir uma descrição concisa da tarefa que deve ser executada
- No caso de issues que executem várias micro tarefas, deve-se colocar essas tarefas na sua descrição em forma de checklist
- Toda issue deve ser atribuída a pelo menos um membro do grupo
- No caso de issues que se refiram a documentos ou ferramentas externas ao Git, o link referente deve estar contido em forma de comentário na issues
# Nomenclatura de título
Deve conter de forma breve a tarefa a ser desenvolvida. Padrão para issues em geral é [Verbo inifinitivo] + [substantivo]. Em casos como Histórias de Usuário (User Story) é preciso colocar a um pre-fixo para referenciar o tipo de Issue, [USX] + [Verbo inifinitivo] + [Substantivo]
Ex:
- Criar documento de visão
- US12 - Manter usuário
# Corpo da Issue
Todas as Issues devem possuir uma descrição detalhada de o que deve ser feito e como deve ser feito.
Em caso de User Story, a issue deve seguir um padrão onde deve responder as seguintes perguntas:
Eu como [Papel], quero [Meta] para que eu possa [Motivo].
Ex.: “Eu, como desenvolvedor, desejo realizar os testes funcionais das classificações, para garantir o devido funcionamento da aplicação”
Casos de Issues que possuem micro taferas após a descrição detalhada, deve haver um checklist de todas as operações que deve ser realizada.
# Classificação de Labels
As labels são etiquetas para auxiliar o desenvolvedor a identificar e direcionar o tipo de issue. As issues levantadas são:
- Documentação: Documentação de todos os tipos que não seja código
- Arrumar problema: Para corrigir bugs encontrados no software
- Código: desenvolvimento de código
- Aprimoramento: melhora de documentação e código
- Pendencia: ficou para a proxima Sprint
- Pull Request: referente a Pull request
- Reunião: definido em reunião
- Precisa de atenção: necessita de atenção ou por pendencia ou por dificuldade
- Ajuda: pessoas que foram atribuídas a ela precisarem de ajuda de outros
# Referências
[1] Github. Configuring issue templates for your repository Issue template [2] Gitlab. Description templates Issue template