Padronização de labels para projetos colaborativos
Como melhorar a atribuição de tarefas usando labels
Para quem está acostumado a trabalhar no desenvolvimento de projetos em equipe no GitHub, GitLab e afins, já deve ter passado pelo seguinte problema: existe alguma issue em aberto para o meu perfil?
Você vai naquela lista imensa de issues, entrando em cada uma, lendo, para no final poder decidir qual é a mais prioritária para o momento.
Além disso cada issue exige diferentes habilidades. Se você for a pessoa do back-end, muito dificilmente irá pegar uma issue de front-end ou UX.
Acaba que muito tempo é perdido só nessa tarefa de busca e decisão sobre qual issue pegar. Para resolver isso, procuro adotar uma padronização de labels nos projetos que participo, pois são um recurso visual que ajuda muito no trabalho em equipe.
Para a padronização das labels, eu adotei duas estrategias:
- Usar um namespace para definir os grupos, visto que um conjunto de labels diferentes (cor, descrição, etc) podem estarem relacionadas a um mesmo contexto;
- Usar cores que representem ou indique algo que quero, como: verde significar algo bom e vermelho algo ruim. Isso permite fazer com que labels de nível mais crítico possuam tonalidades parecidas, para chamar mais a atenção do desenvolvedor.
Labels
Aqui irei apresentar um conjunto de labels que uso. O padrão de apresentação delas será:
- [Título] ([Cor]) — [Descrição]
Os grupos que irei apresentar serão:
- Desenvolvimento (Dev)
- Prioridade
- Equipe
- Outros
Desenvolvimento (Dev)
São um total de 5 labels divididos em dois grupos: “Funcionalidade”, “Documentação” e “Visual/UX” no primeiro grupo (usando o padrão de cores triádico) e “Bug” e “Melhoria” no segundo grupo (suas cores farão mais sentido na frente).
- Bug (#BF3030) — Correção de erro no sistema
- Documentação (#FFC440) — Escrever documento relacionado ao sistema (funcionalidade, visão, etc)
- Funcionalidade (#8742D6) — Desenvolver determinada funcionalidade
- Melhoria (#269926) — Melhoria de requisito/funcionalidade
- Visual/UX (#35D4A4) — Desenvolver algo relacionado ao visual e/ou UX no sistema
Prioridade
As cores utilizadas nessas labels seguem o padrão de “Cores Análogas”, que são cores que estão lado a lado no círculo cromático. “Prioridade: Baixa” está em um extremo e “Prioridade: Alta” no outro.
- Alta (#D9534F) — Demanda importante e prioritária;
- Baixa (#F0AD4E) — Demanda não importante, nem prioritária;
- Média (#D1D100) — Demanda importante, porém não prioritária.
Essas cores eu peguei na paleta que o GitLab possui como padrão.
Esse grupo sempre será usado como complemento a algum outro label.
No exemplo acima, sabemos que é uma tarefa de melhoria de algo, porém de baixa prioridade, portanto podemos focar em outras tarefas com as labels de média e alta prioridade.
Equipe
Elas servem para assuntos que exigem a participação de toda a equipe de projeto, como debater uma nova funcionalidade ou marcar uma reunião (deixando todos cientes sobre qual issue será tratada na mesma).
- Debate (#FFB173) —Debate sobre uma demanda/especificação/funcionalidade;
- Reunião (#FFECDB) —Reunião da equipe.
Outros
Aqui eu coloco labels que eu não coube em nenhum grupo já mencionado. As cores foram definidas como gosto pessoal mesmo.
- Ignorado (#34495E) — Atividades ignoradas ou não condizentes
- Sugestão (#60B9CE) — Sugestão sobre funcionalidade, melhoria, mudança de fluxo, etc
- Suporte (#6FCEC7) — Suporte ao cliente
Observações
Perceba que algumas labels de grupos distintos possuem tonalidades semelhantes.
Vale ressaltar que o padrão a ser seguido tem que ser definido de forma que melhor atenda a equipe de desenvolvimento, podendo adotar diferentes estrategias, como os grupos serem definidos por uma cor e não por um namespace.
Referências
Aqui está algumas referências que tomei na hora de definir esse padrão para as labels:
Algumas ferramentas que vocês podem usar na hora de definir os seus padrões:
Edição 09/09/2019:
Um projeto que gosto muito de acompanhar, principalmente porque utilizo, é o Mark Text. A padronização de labels que eles utilizam é muito interessante, pois além de usarem namespaces e cores, também utilizam emojis. Vale a pena dar uma olhada:
