Rótulos do problema

Os rótulos são um recurso interessante do GitHub que permite filtrar problemas e solicitações de envio. Eles ajudam você a encontrar algo divertido para trabalhar que se encaixe no seu nível de experiência.

Nos nossos repositórios, a adição de novos rótulos aos problemas é tratada exclusivamente pela equipe principal do Blockly, para garantir que as coisas não acabem no lugar errado.

Tamanho

Alguns problemas são pequenos e bonitos, enquanto outros podem levar semanas para serem solucionados. Esses rótulos ajudam a dizer a quantidade de trabalho que um problema provavelmente levará.

  • Primeiro problema: esses problemas são ótimos para pessoas que são novas no repositório. Eles precisam levar menos de metade de um dia de trabalho e exigir pouca familiaridade 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 utilizado pode ser um processo confidencial, e alguns problemas podem ser mais sensíveis. Esses rótulos ajudam a dizer quais problemas estão abertos para contribuição e quais problemas evitar.

  • Precisa de ajuda:esses problemas são reservados aos colaboradores. Muitas vezes, são recursos que a equipe principal acha que seriam úteis, mas que não têm tempo para implementar. Eles podem precisar de uma discussão ou implementação. Portanto, verifique o rótulo de status para ver qual trabalho é necessário. Esse é um bom lugar para encontrar projetos criativos divertidos.
  • Interno: esses problemas são reservados aos membros da equipe principal. Muitas vezes, eles são bugs sensíveis ou complexos que precisam de discussão especial. É melhor evitar isso, porque a situação ao redor deles pode mudar rapidamente!
  • Nenhum dos dois: problemas que não têm nenhum rótulo podem ser corrigidos por colaboradores e membros da equipe principal. Se você encontrar um problema não rotulado que parece interessante, siga em frente.

Status

Certos problemas (especialmente solicitações de recursos) passam por algumas fases diferentes antes de serem considerados "fechados". Esses rótulos informam em que estágio um problema está no momento, para que você saiba o que precisa ser feito a seguir.

  • Discussão:esses problemas estão na fase de discussão, o que significa que ainda há questões que precisam ser respondidas antes da implementação. Se você tiver algum comentário relacionado a esse problema, mande um comentário. Estamos sempre em busca de mais opiniões.
  • Implementação: esses problemas foram discutidos o suficiente para serem claramente definidos e passaram para a fase de implementação. Eles estão aguardando a implementação ou já estão sendo implementados. Se você tiver interesse em trabalhar em um desses, leia o problema completo e deixe um comentário dizendo em qual parte você quer trabalhar. Depois, avance e vá em frente!
  • Nenhum: problemas sem nenhum 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. Como alternativa, se você tiver interesse em trabalhar no problema, é melhor deixar um comentário perguntando se ele está pronto para ser implementado.

Tipo

Problemas diferentes exigem respostas diferentes. Alguns exigem apenas a edição de algumas linhas de código, enquanto outros precisam de muito design e discussão. Esses rótulos informam que tipo de ação um problema precisará.

  • Bug (link em inglês): esses problemas documentam um problema com a base de código. Eles geralmente precisam de alguma depuração para diagnosticar o que está causando o problema, mas alguns podem ser corrigidos rapidamente. Se você gosta de se aprofundar para saber como o código funciona, esses serão ótimos problemas. Corrija o bug ou analise o problema e escreva uma explicação clara da causa raiz.
  • Solicitação de recurso: esses problemas documentam um recurso que alguém gostaria de adicionar. Isso pode se aplicar 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 do código. Geralmente, essas perguntas são redirecionadas para o fórum de desenvolvedores, mas, se você achar que pode ajudar, entre em contato e responda.

Categoria

Esse repositório contém alguns tipos diferentes de projetos, com alguns tipos diferentes de públicos-alvo. Se você adora tutoriais ou adora trabalhar em plug-ins, esses marcadores 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 (link em inglês): esses problemas estão relacionados aos plug-ins do Blockly, um conjunto de extensões que adicionam a funcionalidade do Blockly.

Projeto

Se você quiser uma ainda mais granular, também há tags para projetos individuais. Eles geralmente são criados para plug-ins, que tendem a ter mais problemas relacionados a eles, mas também podem ser criados para codelabs e exemplos. Se você tem um projeto específico em que tenha interesse, esses rótulos podem ajudar a encontrar problemas relacionados a ele.

Observe também que novos projetos são adicionados com frequência, então essa lista pode ficar desatualizada. Verifique a lista completa de rótulos se não encontrar uma entrada para o projeto em que você tem interesse.

Outros

Como acontece com qualquer coleção de itens, há algumas bolas ímpares que você precisa conhecer. Esses rótulos 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 devidamente rotulados pela equipe principal. Os problemas com esse rótulo já podem incluir outro rótulo simples, como bug ou solicitação de recurso, mas é provável que mais rótulos sejam adicionados em breve.
  • Cópia:esses problemas documentam um problema, solicitação ou dúvida que já foi coberto por outro problema. Esse rótulo informa que você não deve responder a esse problema, mas sim responder ao problema original.