Os rótulos são um recurso interessante do GitHub que permite filtrar problemas e solicitações de pull. Eles ajudam você a encontrar algo divertido para trabalhar que se encaixe no seu nível de experiência.
Para nossos repositórios, a adição de novos rótulos a problemas é feita exclusivamente pela equipe principal do Blockly para garantir que as coisas não acabem no lugar errado.
Tamanho
Alguns problemas são pequenos e fáceis de resolver, enquanto outros podem levar semanas. Esses rótulos ajudam você a saber quanto trabalho um problema provavelmente vai levar.
- Boa primeira questão:Essas questões são ótimas para pessoas que não conhecem o repositório. Elas devem levar menos de meio dia de trabalho e exigir familiaridade limitada com a base de código. Você pode começar a trabalhar nesses problemas imediatamente, sem aprovação da equipe.
Jurisdição
Trabalhar em um repositório amplamente usado pode ser um processo delicado, e alguns problemas podem ser mais sensíveis do que outros. Esses rótulos ajudam você a saber quais problemas estão abertos para contribuição e quais devem ser evitados.
- Precisamos de ajuda:esses problemas são reservados para colaboradores. Muitas vezes, são recursos que a equipe principal acha úteis, mas não tem tempo para implementar. Talvez seja necessário discutir ou implementar. Por isso, verifique o marcador de status para saber o que precisa ser feito. Este é um bom lugar para encontrar projetos criativos e divertidos.
- Internos:esses problemas são reservados para membros da equipe principal. Muitas vezes, são bugs sensíveis ou complexos que precisam de uma discussão especial. É melhor evitar esses lugares porque a situação ao redor deles pode mudar rapidamente.
- Nenhum:problemas que não têm nenhum dos rótulos podem ser corrigidos por colaboradores e membros da equipe principal. Se você encontrar um problema sem rótulo que pareça interessante, aceite-o.
Status
Alguns problemas (principalmente solicitações de recursos) passam por algumas etapas diferentes antes de serem considerados "resolvidos". Esses rótulos informam em qual estágio um problema está no momento, para que você saiba o que precisa ser feito em seguida.
- Discussão:esses problemas estão na fase de discussão, o que significa que ainda há perguntas que precisam ser respondidas antes da implementação. Se tiver alguma opinião sobre esse assunto, deixe um comentário. Estamos sempre em busca de mais informações.
- Implementação:Esses problemas já foram discutidos o suficiente para serem definidos claramente e passaram para a fase de implementação. Elas estão aguardando a implementação ou já estão sendo implementadas. Se você quiser trabalhar em um deles, leia toda a edição e deixe um comentário dizendo em qual parte você quer trabalhar. Depois, é só começar!
- Nenhum:problemas sem rótulo podem estar em qualquer um dos estados. Se você tiver uma opinião sobre como o problema deve ser implementado, deixe um comentário. Se você tiver interesse em trabalhar no problema, deixe um comentário perguntando se ele está pronto para ser implementado.
Tipo
Problemas diferentes exigem respostas diferentes. Algumas exigem apenas a edição de algumas linhas de código, enquanto outras precisam de muito design e discussão. Esses rótulos informam o tipo de ação necessária para resolver um problema.
- Bug:esses problemas documentam um problema com a base de código. Muitas vezes, é necessário fazer um pouco de depuração para diagnosticar a causa do problema, mas alguns podem ser corrigidos em um piscar de olhos. Se você gosta de se aprofundar para aprender como o código funciona, esses são ótimos problemas para você. Você pode ajudar corrigindo o bug ou investigando para entender o problema e escrevendo uma explicação clara da causa raiz.
- Solicitação de recurso:esses problemas documentam um recurso que alguém gostaria de adicionar. Isso pode ser aplicado ao repositório como um todo ou a um projeto individual. Se você gosta de desenvolver ideias de design e adicionar novas funcionalidades, esses podem ser os problemas perfeitos para você.
- Pergunta: Esses problemas documentam uma dúvida que alguém tem sobre a base de código. Em geral, essas perguntas são redirecionadas para o fórum de desenvolvedores, mas, se você vir uma pergunta que pode ajudar a responder, fique à vontade para participar e responder.
Categoria
Esse repositório contém alguns tipos diferentes de projetos, com alguns tipos diferentes de públicos-alvo. Se você gosta de tutoriais ou de trabalhar com plug-ins, esses rótulos podem ajudar a encontrar problemas do seu interesse.
- Codelab:esses problemas estão relacionados aos codelabs do Blockly, um conjunto de tutoriais interativos.
- Exemplo: esses problemas estão relacionados aos exemplos do Blockly, um conjunto de demonstrações independentes que mostram como incluir e estender o Blockly.
- Plug-in:esses problemas estão relacionados aos plug-ins do Blockly, uma coleção de extensões que adicionam funcionalidade ao Blockly.
Projeto
E se você quiser um controle ainda mais refinado, também há tags para projetos individuais. Eles geralmente são criados para plug-ins, que tendem a ter mais problemas relacionados, mas também podem ser criados para codelabs e exemplos. Se você tiver um projeto específico em mente, esses rótulos podem ajudar a encontrar problemas relacionados a ele.
Para saber se há um rótulo para o projeto em que você tem interesse, consulte a lista completa de rótulos:
Outro
Como em qualquer coleção de coisas, há algumas peculiaridades que você também precisa conhecer. Esses marcadores podem não ser tão úteis quando você está procurando um problema para trabalhar, mas ainda podem ser informativos.
- Triagem:esses problemas ainda não foram rotulados corretamente pela equipe principal. Problemas com esse rótulo já podem incluir outro rótulo simples, como bug ou pedido de recurso, mas é provável que mais rótulos sejam adicionados em breve.
- Duplicado:esses problemas documentam um problema, uma solicitação ou uma dúvida que já foi abordada em outro problema. Esse rótulo indica que você não deve responder a esse problema, mas sim ao problema original.