> For the complete documentation index, see [llms.txt](https://cumbucadev.gitbook.io/github-essentials/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cumbucadev.gitbook.io/github-essentials/dia-8/categorizando-issues-de-um-repositorio-atraves-de-labels-no-github/gerenciando-labels-de-um-repositorio-no-github.md).

# Gerenciando Labels de um Repositório no GitHub

Como visto na seção anterior, labels são uma ferramenta essencial para organizar issues e pull requests em um repositório do GitHub. Elas permitem categorizar, priorizar e atribuir significado às tarefas dentro do projeto. Agora vamos explorar como acessar, criar, editar e deletar labels de forma simples e eficiente.

## Como Gerenciar Labels

### Acessando a página de labels

1. Acesse o repositório no GitHub.
2. Navegue até a aba **Issues**.
3. Clique no botão **Labels** no topo da página.

Alternativamente, acesse diretamente via URL:

> &#x20;`https://github.com/<conta_do_github>/<repositorio>/labels`&#x20;

Substituindo `<conta_do_github>` e `<repositorio>` pelos valores correspondentes. Exemplo:

> <https://github.com/aprendizCumbucaDev/hello-world/labels>

### Criar uma label

1. Acesse a página de labels do repositório.
2. Clique em **New label**.
3. Preencha os seguintes campos:
   * **Nome**: `exemplo-label`
   * **Cor**: Escolha uma cor distintiva (exemplo: azul `#1f77b4`).
   * **Descrição**: `Esta é uma label de exemplo para categorizar issues relacionadas a testes.`
4. Clique em **Create label** para salvar.

### Editar uma label

1. Acesse a página de labels do repositório.
2. Encontre a label que deseja modificar.
3. Clique no botão **Edit** ao lado da label.
4. Altere os campos necessários (nome, cor ou descrição).
5. Clique em **Save changes** para salvar as modificações.

### Deletar uma label

1. Acesse a página de labels do repositório.
2. Localize a label que deseja excluir.
3. Clique no botão **Delete** ao lado da label.
4. Confirme a exclusão.

## Sua vez!

Agora que você aprendeu sobre labels, siga os passos abaixo para praticar.

1. Acesse a aba **Labels** do repositório.
2. Clique em **New label** e crie uma label de teste com:
   * Nome: `teste-label`
   * Cor: Vermelho `#d73a4a`
   * Descrição: `Label de teste para aprendizado`
3. Edite a label alterando a cor para verde `#0e8a16` e a descrição para `Label de teste editada`
4. Por fim, delete a label criada.

***

Com esse conhecimento, você pode gerenciar labels de maneira eficiente, melhorando a organização e a colaboração dentro do repositório. O uso adequado de labels facilita a identificação de prioridades e contribui para um fluxo de trabalho mais produtivo no GitHub.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://cumbucadev.gitbook.io/github-essentials/dia-8/categorizando-issues-de-um-repositorio-atraves-de-labels-no-github/gerenciando-labels-de-um-repositorio-no-github.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
