Skip to main content

Gerenciar etiquetas

Você pode classificar problemas, solicitações de pull e discussões criando, editando, aplicando e excluindo etiquetas.

Sobre etiquetas

Você pode gerenciar seu trabalho no GitHub criando rótulos para classificar problemas, solicitações de pull e discussões. Você pode aplicar etiquetas no repositório em que foram criadas. Depois que houver um rótulo, você poderá usá-lo em qualquer problema, solicitação de pull ou discussão nesse repositório.

Sobre as etiquetas padrão

O GitHub fornece etiquetas padrão para todos os repositórios novos. Você pode usar esses rótulos padrão para ajudar a criar um fluxo de trabalho padrão em um repositório.

RótuloDescrição
bugIndica um problema inesperado ou um comportamento não intencional
documentationIndica a necessidade de aprimoramentos ou adições à documentação
duplicateIndica problemas, solicitações de pull ou discussões semelhantes
enhancementIndica novas solicitações de recurso
good first issueIndica um bom problema para contribuidores principiantes
help wantedIndica que um mantenedor deseja ajudar em um problema ou uma pull request
invalidIndica que um problema, uma solicitação de pull ou uma discussão não é mais relevante
questionIndica que um problema, uma solicitação de pull ou uma discussão precisa de mais informações
wontfixIndica que o trabalho não continuará em um problema, solicitação de pull ou discussão

Etiquetas padrão são incluídas em todos os novos repositórios quando criados, mas você pode editar ou excluir as etiquetas posteriormente.

Os problemas com o rótulo problema good first issue são usados para preencher a página contribute do repositório. Para ver um exemplo de uma página contribute, confira github/docs/contribute.

Os proprietários da organização podem personalizar os rótulos padrão dos repositórios em sua organização. Para obter mais informações, confira "Gerenciar etiquetas padrão para repositórios na organização".

Criar uma etiqueta

Qualquer pessoa com acesso de gravação a um repositório pode criar uma etiqueta.

  1. No GitHub.com, navegue até a página principal do repositório.

  2. No nome do repositório, clique em Problemas do ou Solicitações de pull do .

    Captura de tela da página principal de um repositório. Há duas guias na barra de navegação horizontal, "Problemas" e "Solicitações de pull", com o contorno em laranja escuro.

  3. Acima da lista de problemas ou solicitações de pull, clique em Rótulos.

    Captura de tela da lista de problemas de um repositório. Acima da lista, há um botão com um ícone de rótulo "Rótulos" e o contorno em laranja escuro.

  4. À direita do campo de pesquisa, clique em Novo rótulo.

  5. Em "Nome da etiqueta", digite um nome para a sua etiqueta.

  6. Em "Descrição", digite uma descrição para ajudar outras pessoas a entender e usar a sua etiqueta.

  7. Opcionalmente, para personalizar a cor do rótulo, edite o número hexadecimal ou, para outra seleção aleatória, clique em .

  8. Para salvar o novo rótulo, clique em Criar rótulo.

Aplicando uma etiqueta

Qualquer pessoa com acesso de triagem a um repositório pode aplicar e ignorar etiquetas.

  1. Procure o problema, a solicitação de pull ou a discussão.
  2. Na barra lateral direita, clique em Rótulos e selecione um rótulo.

Editar uma etiqueta

Qualquer pessoa com acesso de gravação a um repositório pode editar etiquetas existentes.

  1. No GitHub.com, navegue até a página principal do repositório.

  2. No nome do repositório, clique em Problemas do ou Solicitações de pull do .

    Captura de tela da página principal de um repositório. Há duas guias na barra de navegação horizontal, "Problemas" e "Solicitações de pull", com o contorno em laranja escuro.

  3. Acima da lista de problemas ou solicitações de pull, clique em Rótulos.

    Captura de tela da lista de problemas de um repositório. Acima da lista, há um botão com um ícone de rótulo "Rótulos" e o contorno em laranja escuro.

  4. Na lista de etiquetas, à direita da etiqueta que deseja editar, clique em Editar.

  5. Em "Nome da etiqueta", digite um nome para a sua etiqueta.

  6. Em "Descrição", digite uma descrição para ajudar outras pessoas a entender e usar a sua etiqueta.

  7. Opcionalmente, para personalizar a cor do rótulo, edite o número hexadecimal ou, para outra seleção aleatória, clique em .

  8. Clique em Salvar alterações.

Excluir uma etiqueta

Qualquer pessoa com acesso de gravação a um repositório pode excluir etiquetas existentes.

Excluir uma etiqueta removerá a etiqueta dos problemas e pull requests.

  1. No GitHub.com, navegue até a página principal do repositório.

  2. No nome do repositório, clique em Problemas do ou Solicitações de pull do .

    Captura de tela da página principal de um repositório. Há duas guias na barra de navegação horizontal, "Problemas" e "Solicitações de pull", com o contorno em laranja escuro.

  3. Acima da lista de problemas ou solicitações de pull, clique em Rótulos.

    Captura de tela da lista de problemas de um repositório. Acima da lista, há um botão com um ícone de rótulo "Rótulos" e o contorno em laranja escuro.

  4. Na lista de rótulos, à direita do rótulo que deseja excluir, clique em Excluir.

Leitura adicional