LogoLogo
  • Git e GitHub para Humanos
  • Sumário
  • 1. Antes de Começar
    • 1.1 Este Livro é para Você?
    • 1.2 A Razão por Trás Deste Livro
    • 1.3 Visão Geral
    • 1.4 Sobre o GitHub
    • 1.5 Sobre a Cumbuca Dev
    • 1.6 O Maravilhoso Mundo do Open Source
    • 1.7 Mapa do Livro
    • 1.8 Glossário: Capítulo 1
  • 2. Fundamentos de Controle de Versão e Git
    • 2.1 Introdução a Sistemas de Controle de Versão
      • 2.1.1 Sistemas de Controle de Versão Centralizados
      • 2.1.2 Sistemas de Controle de Versão Distribuídos
    • 2.2 Introdução ao Git
    • 2.3 Conceitos Fundamentais do Git
      • 2.3.1 Repositório
      • 2.3.2 Commit
      • 2.3.3 Branch
      • 2.3.4 Merge
    • 2.4 Instalando o Git
      • 2.4.1 Instalando no Linux
      • 2.4.2 Instalando no macOS
      • 2.4.3 Instalando no Windows
    • 2.5 Interagindo com o Git
    • 2.6 O Comando Git
    • 2.7 Inicializando de um Repositório Local
    • 2.8 Configurando de um Repositório Local
    • 2.9 Links Úteis: Capítulo 2
    • 2.10 Glossário: Capítulo 2
  • 3. Operações Locais Básicas no Git
    • 3.1 Explorando Operações Locais do Git
    • 3.2 Salvando Alterações Localmente
      • 3.2.1 Adicionando Arquivos ao Controle de Versão via `git add`
      • 3.2.2 Verificando o Estado do Repositório via `git status`
      • 3.2.3 Criando Commits via `git commit`
      • 3.2.4 Visualizando o Histórico do Repositório via `git log`
      • 3.2.5 Comparando Alterações via `git diff`
      • 3.2.6 Unindo os Pontos
      • 3.2.7 Exemplo Prático
    • 3.3 Trabalhando com Branches Localmente
      • 3.3.1 Gerenciando Branches via `git branch`
      • 3.3.2 Alternando Entre Branches via `git switch`
      • 3.3.3 Mesclando Branches via `git merge`
        • 3.3.3.1 Resolvendo Conflitos de Merge
      • 3.3.4 Unindo os Pontos
      • 3.3.5 Exemplo Prático
    • 3.4 Links Úteis: Capítulo 3
    • 3.5 Glossário: Capítulo 3
  • 4. Ajuste de Mudanças Locais no Git
    • 4.1 Desfazendo Alterações Localmente
      • 4.1.1 Desfazendo Alterações Antes do Commit
      • 4.1.2 Desfazendo Commits
      • 4.1.3 Alterando o Último Commit via `git commit --amend`
      • 4.1.4 Unindo os Pontos
      • 4.1.5 Exemplos Práticos
    • 4.2 Ignorando e Removendo Arquivos do Rastreamento Local
      • 4.2.1 Ignorando Arquivos do Rastreamento Utilizando o arquivo .gitignore
      • 4.2.2 Removendo Arquivos do Rastreamento via `git rm`
    • 4.3 Links Úteis: Capítulo 4
    • 4.4 Glossário: Capítulo 4
  • 5. Introdução ao GitHub
    • 5.1 Qual a diferença entre Git e GitHub?
    • 5.2 Grandes Projetos Abertos no GitHub
    • 5.3 Recursos do GitHub
    • 5.4 Idioma Suportado no GitHub
    • 5.5 Contas no GitHub
      • 5.5.1 Conta Pessoal
      • 5.5.2 Conta de Organização
      • 5.5.3 Conta Corporativa
      • 5.5.4 Unindo os Pontos
    • 5.6 Planos do GitHub
    • 5.7 Criando uma Conta Pessoal no GitHub
    • 5.8 Explorando a Interface do GitHub
      • 5.8.1 Página Principal (Home)
      • 5.8.2 Página de Notificações (Notifications)
      • 5.8.3 Página de Configurações (Settings)
    • 5.9 Links Úteis: Capítulo 5
    • 5.10 Glossário: Capítulo 5
  • 6. Repositórios no GitHub
    • 6.1 O quê é um Repositório no GitHub?
    • 6.2 Criando um Repositório no GitHub
    • 6.3 Página Principal de um Repositório: Aba Code
      • 6.3.1 Editando um Arquivo em um Repositório no GitHub
      • 6.3.2 Explorando o Histórico de Commits de um Repositório no GitHub
      • 6.3.3 Editando Detalhes de um Repositório no GitHub
      • 6.3.4 Explorando um Repositório Ativo em Uso
    • 6.4 Página de Configurações de um Repositório: Aba Settings
      • 6.4.1 Gerenciando Configurações Gerais de um Repositório no GitHub: Menu General
      • 6.4.2 Gerenciando Configurações de Colaboração de um Repositório no GitHub: Menu Collaborators
      • 6.4.3 Explorando Configurações de um Repositório no GitHub na Prática
    • 6.5 Links Úteis: Capítulo 6
    • 6.6 Glossário: Capítulo 6
  • 7. Documentação de Projetos
    • 7.1 O quê é Documentação de Projeto?
    • 7.2 Explorando a Linguagem de Marcação Markdown
    • 7.3 Criando uma Página de Apresentação no GitHub
    • 7.4 Links Úteis: Capítulo 7
    • 7.5 Glossário: Capítulo 7
  • 8. Issues no GitHub
    • 8.1 O quê é GitHub Issues?
    • 8.2 Criando uma Issue no GitHub
    • 8.3 Explorando a Página de uma Issue no GitHub
    • 8.4 Atribuindo uma Issue no GitHub
    • 8.5 Categorizando Issues de um Repositório através de Labels no GitHub
      • 8.5.1 Gerenciando Labels de um Repositório no GitHub
    • 8.6 Página de Issues de um Repositório no GitHub: Aba Issues
    • 8.7 Explorando Issues no Mundo Real
    • 8.8 Links Úteis: Capítulo 8
    • 8.9 Glossário: Capítulo 8
  • 9. Git Remoto
    • 9.1 Explorando Operações Remotas do Git
    • 9.2 Interagindo com o Repositório Remoto Central no Git
      • 9.2.1 Clonando um Repositório Remoto via `git clone`
      • 9.2.2 Buscar Atualizações de um Repositório Remoto via `git fetch`
      • 9.2.3 Enviando Mudanças Locais para o Repositório Remoto via `git push`
      • 9.2.4 Sincronizando o Repositório Local com o Remoto via `git pull`
      • 9.2.5 Unindo os Pontos
      • 9.2.6 Exemplo
    • 9.3 Interagindo com o Repositório Remoto hello-world
      • 9.3.1 Conectando-se ao GitHub via SSH
      • 9.3.2 Clonando o Repositório hello-world
      • 9.3.3 Alterando hello-world Localmente
        • 9.3.3.1 Editor de Código
        • 9.3.3.2 Editando README.md
        • 9.3.3.3 Salvando Alterações no Controle de Versão Local
      • 9.3.4 Enviando Alterações para o Repositório Remoto
    • 9.4 Links Úteis: Capítulo 9
    • 9.5 Glossário: Capítulo 9
  • 10. Pull Requests no GitHub
    • 10.1 O quê é um Pull Requests no GitHub?
    • 10.2 Entendendo as Propriedades de um Pull Request no GitHub
      • 10.2.1 Branches de Origem e de Destino de um Pull Request
      • 10.2.2 Título de um Pull Request
      • 10.2.3 Descrição de um Pull Request
      • 10.2.4 Modificações de um Pull Request
      • 10.2.5 Pessoas Revisoras de um Pull Request
      • 10.2.6 Labels de um Pull Request
    • 10.3 Criando um Pull Request no GitHub
    • 10.4 Página de um Pull Request no GitHub
      • 10.4.1 Aba Conversation
      • 10.4.2 Aba Commits
      • 10.4.3 Aba Checks
      • 10.4.4 Aba Files Changed
    • 10.5 Página de Pull Requests de um Repositório no GitHub: Aba Pull Requests
    • 10.6 Recebendo Revisões em um Pull Request no GitHub
      • 10.6.1 Boas Práticas
      • 10.6.2 Exemplo Prático
        • 10.6.2.1 Adicionando Conta Colaboradora
        • 10.6.2.2 Solicitando Revisão de Pull Request
        • 10.6.2.3 Lidando com o Feedback
    • 10.7 Mesclando um Pull Request no GitHub
      • 10.7.1 Exemplo Prático
    • 10.8 Atualizando um Repositório Local Após Mesclagem
    • 10.9 Explorando Pull Requests no Mundo Real
    • 10.10 Links Úteis: Capítulo 10
    • 10.11 Glossário: Capítulo 10
  • 11. Fluxo de Trabalho
    • 11.1 Fork no GitHub
      • Fork
    • 11.2 Forks e Pull Requests
      • 11.2.1 Criando um Fork no GitHub
      • 11.2.2 Clonando um Fork
      • 11.2.3 Realizando Alterações Localmente
      • 11.2.4 Enviando Alterações Locais para o Fork Remoto
      • 11.2.5 Criando um Pull Request a partir de um Fork no GitHub
      • 11.2.6 Sincronizando um Fork no GitHub
      • 11.2.7 Revisão, Mesclagem e Atualizações Pós-mesclagem
    • 11.3 Fluxo de Trabalho
  • 11.4 Links Úteis - Capítulo 11
  • 11.5 Glossário - Capítulo 11
  • 12. O Caminho Continua
    • 12.1 Conhecendo Ferramentas Adicionais
      • 12.1.1 Indicação: Jogo Oh My Git
    • 12.2 Explorando Projetos Open Source
    • 12.3 Crescendo e Colaborando em Comunidades
    • 12.4 Desafio: GitCaos 🔥
    • 12.5 Links Úteis - Capítulo 12
    • 12.6 Glossário Completo: Git e GitHub para Humanos
Fornecido por GitBook
Nesta página
  • Labels em Issues vs. Labels em Pull Requests
  • Labels em Issues
  • Labels em Pull Requests
  • Boas Práticas
  • 1. Defina um conjunto fixo de labels
  • 2. Use nomenclaturas claras e objetivas
  • 3. Mantenha um equilíbrio na quantidade de labels por item
  • 4. Utilize cores de forma estratégica
  • 5. Documente o uso das labels
  • 6. Siga as diretrizes do projeto ao contribuir para repositórios externos
  • Gerenciamento de Labels
  • Como Adicionar uma Label a um PR
  • Como Remover uma Label de um PR

Isto foi útil?

Editar no GitHub
Exportar como PDF
  1. 10. Pull Requests no GitHub
  2. 10.2 Entendendo as Propriedades de um Pull Request no GitHub

10.2.6 Labels de um Pull Request

Como já vimos anteriormente, labels são marcadores categorizados usados no GitHub para organizar e classificar Issues e Pull Requests. Elas ajudam a identificar rapidamente o status, prioridade e tipo de cada item, tornando a colaboração mais eficiente, especialmente em projetos de código aberto.

Labels em Issues vs. Labels em Pull Requests

As labels podem ser aplicadas tanto em Issues quanto em Pull Requests, mas possuem finalidades distintas, uma vez que:

  • Issues representam tarefas a serem realizadas.

  • Pull Requests indicam trabalho em andamento ou concluído.

Labels em Issues

Nas Issues, as labels ajudam a classificar e organizar problemas e sugestões antes que alguém trabalhe neles. Algumas categorias comuns incluem:

  • Tipo – bug (erro), feature request (solicitação de funcionalidade), documentação (documentação).

  • Dificuldade – good first issue (boa primeira issue), help wanted (ajuda necessária).

  • Área do código – frontend (frontend), backend (backend), API (API).

  • Status – triaged (triado), needs discussion (precisa de discussão).

  • Prioridade – high priority (alta prioridade), low priority (baixa prioridade).

Exemplo: Uma Issue pode ter as labels bug (indicando um problema) e high priority (mostrando que precisa ser resolvida rapidamente).

Labels em Pull Requests

Nos Pull Requests, as labels ajudam a acompanhar o progresso da implementação e garantir que a alteração seja revisada corretamente. Algumas categorias comuns incluem:

  • Tipo de mudança – bug fix (correção de bug), enhancement (melhoria), documentation (documentação).

  • Status do PR – in progress (em andamento), needs review (precisa de revisão), ready to merge (pronto para mesclar).

  • Impacto – breaking change (mudança quebradora), critical change (mudança crítica).

  • Requisitos especiais – needs tests (precisa de testes), needs more info (precisa de mais informações).

Exemplo: Se um PR corrige um bug, ele pode ter a label bug fix (indicando que resolve um problema) e needs review (para mostrar que necessita de avaliação antes da mesclagem).

Em resumo, Labels em Issues organizam o que precisa ser feito, enquanto labels em PRs organizam o que está sendo feito. Isso melhora o fluxo de trabalho, especialmente em projetos grandes.

Boas Práticas

1. Defina um conjunto fixo de labels

Evite criar variações desnecessárias. Um conjunto padronizado melhora a organização e facilita o entendimento para todos os contribuidores.

2. Use nomenclaturas claras e objetivas

Escolha nomes intuitivos e curtos, evitando abreviações confusas. Exemplo: bug é mais compreensível do que defeito-rep.

3. Mantenha um equilíbrio na quantidade de labels por item

Não exagere no uso de labels em uma única Issue ou PR. O excesso pode dificultar a visualização do que realmente importa.

4. Utilize cores de forma estratégica

Cores ajudam a categorizar labels visualmente. Por exemplo:

  • Vermelho para prioridade alta

  • Verde para melhorias

  • Amarelo para mudanças críticas

5. Documente o uso das labels

Inclua uma seção sobre labels no README.md ou CONTRIBUTING.md do repositório. Isso ajuda novos contribuidores a entenderem seu propósito e uso correto.

6. Siga as diretrizes do projeto ao contribuir para repositórios externos

Se estiver contribuindo para um projeto de terceiros, siga o padrão de labels já estabelecido para manter a consistência.

Gerenciamento de Labels

O gerenciamento de labels ocorre no mesmo local e da mesma forma mencionados em 8.5.1 Gerenciando Labels de um Repositório no GitHub. Isso acontece porque, no GitHub, labels não são exclusivas para Issues ou Pull Requests; na verdade, elas fazem parte de um único conjunto de labels do repositório. Isso significa que qualquer label criada, na prática, pode ser aplicada tanto a Issues quanto a PRs.

Por convenção, uma equipe pode decidir utilizar determinadas labels exclusivamente para Issues ou PRs, a fim de manter uma organização mais clara. No entanto, se essa prática for adotada, é essencial documentá-la para garantir que todos os colaboradores entendam o uso correto de cada label.

Como Adicionar uma Label a um PR

  1. Acesse o repositório no GitHub.

  2. Navegue até a aba Pull Requests e abra o PR desejado.

  3. No menu lateral direito, clique na engrenagem (⚙️) ao lado da palavra Labels.

  4. Selecione uma ou mais labels na lista.

  5. A label será automaticamente adicionada ao PR.

Dica: Caso não veja a opção de adicionar labels, verifique se você tem as permissões adequadas no repositório.

Como Remover uma Label de um PR

  1. Acesse o repositório no GitHub.

  2. Navegue até a aba Pull Requests e abra o PR desejado.

  3. No menu lateral direito, clique na engrenagem (⚙️) ao lado da palavra Labels.

  4. Desmarque a label que deseja remover.

  5. A label será removida imediatamente do PR.

Remover labels desatualizadas pode ajudar a manter o fluxo de trabalho organizado.

O uso correto de labels no GitHub melhora a organização e colaboração no projeto. Seguindo as boas práticas e mantendo um conjunto claro de labels, o time consegue trabalhar de forma mais eficiente e estruturada.

Anterior10.2.5 Pessoas Revisoras de um Pull RequestPróximo10.3 Criando um Pull Request no GitHub

Atualizado há 14 dias

Isto foi útil?