8.6 Página de Issues de um Repositório no GitHub: Aba Issues

A página principal de Issues no GitHub lista todas as issues de um repositório, permitindo que você visualize, busque e filtre as tarefas registradas. Aqui, abordaremos os elementos essenciais para que você possa navegar e utilizar essa ferramenta de maneira simples e eficiente.

Barra de Busca

A barra de busca permite procurar por issues específicas dentro do repositório. Você pode digitar palavras-chave para encontrar rapidamente algo relevante.

Exemplo de uso: Digite "saudação" para encontrar todas as issues que mencionam essa palavra.

Se quiser usar filtros mais avançados na busca, consulte a documentação oficial do GitHub.

Botão "Labels"

O botão "Labels", localizado logo ao lado da barra de busca, leva à página de gerenciamento de labels do repositório (8.5.1 Gerenciando Labels de um Repositório no GitHub). Lá, é possível criar, editar e excluir labels utilizadas para categorizar as issues.

Botão "New Issue"

O botão "New Issue" permite criar uma nova issue no repositório. Utilize-o para relatar problemas, sugerir melhorias ou registrar tarefas pendentes (8.2 Criando uma Issue no GitHub).

Cabeçalho da Lista de Issues

Checkbox para Selecionar ou Desselecionar Tudo

No cabeçalho da lista de issues, há um checkbox que permite selecionar ou desmarcar todas as issues visíveis na página. Isso facilita a aplicação de ações em lote, como fechar múltiplas issues de uma vez.

Filtros

Logo abaixo da barra de busca, há filtros prontos que ajudam a visualizar as issues de acordo com seu status:

• Open (Abertas): Exibe apenas issues que ainda estão pendentes ou em discussão.

• Closed (Fechadas): Exibe apenas issues que já foram resolvidas ou descartadas.

• Author (Pessoa Autora): Filtra as issues criadas por uma pessoa específica.

• Labels (Etiquetas): Permite visualizar issues associadas a determinadas etiquetas. Basta clicar no filtro "Labels" e selecionar uma ou mais etiquetas para encontrar issues categorizadas de maneira específica.

• Assignees (Pessoas Atribuídas): Filtra as issues atribuídas a uma pessoa colaboradora específica.

Ordenação das Issues

Por padrão, as issues são exibidas das mais recentes para as mais antigas. Você pode mudar essa ordenação clicando no botão "Newest" e escolhendo outras opções:

• Created on (Criadas em): Ordena as issues pela data de criação.

• Last updated (Última atualização): Ordena as issues com base na última atualização.

• Total comments (Total de comentários): Ordena as issues pelo número total de comentários.

• Best match (Melhor correspondência): Exibe as issues mais relevantes para a sua busca.

• Reactions (Reações): Ordena as issues com base nas reações que receberam.

Além disso, você pode escolher entre Newest (Mais recentes) ou Oldest (Mais antigas) para definir a direção da ordenação.

Lista de Issues

Aqui é onde estão disponíveis todas as issues do repositório. A lista de issues exibirá os resultados conforme os filtros aplicados, a ordenação selecionada e os termos digitados na barra de busca. Cada issue aparece como um cartão contendo:.

• Caixa de seleção para ações em lote;

• O título da issue (que resume o problema ou sugestão);

• O número da issue (um identificador único);

• Quem abriu a issue e quando;

• O número de comentários que a issue recebeu;

• Labels (se aplicáveis), para facilitar a identificação da categoria.

Clique em uma issue para acessar diretamente a página dessa issue.

A aba Issues no GitHub é essencial para acompanhar e discutir tarefas dentro de um projeto. Por enquanto, focamos apenas no básico para você começar. Conforme for ganhando experiência, você pode explorar outras funções mais avançadas, como projetos e milestones.