Classificar repositório com tópicos

Para ajudar outras pessoas a encontrar seu projeto e a contribuir com ele, você pode adicionar tópicos ao repositório relacionados à intenção do projeto, área de assunto, grupos de afinidade ou outras características importantes.

Neste artigo

Sobre tópicos

Com tópicos, você pode explorar repositórios em uma área de assunto específica, encontrar projetos com os quais contribuir e descobrir novas soluções para um problema específico. Os tópicos aparecem na página principal de um repositório. Clique no nome de um tópico para pesquisar outros repositórios com esse tópico.

Captura de tela do repositório github/docs. Na barra lateral direita, três tópicos estão contornados em laranja escuro: "docs" "hacktoberfest" e "works-with-codespaces".

Para navegar pelos tópicos mais usados, vá para http(s)://HOSTNAME/topics/.

Os administradores de repositório podem adicionar qualquer tópico que desejarem a um repositório. Os tópicos úteis para classificar um repositório incluem a finalidade pretendida do repositório, a área de assunto, a comunidade ou a linguagem.

Os repositórios público, privado e interno podem ter tópicos, embora você veja apenas repositórios privados aos quais você tem acesso nos resultados de pesquisa de tópicos.

Você pode pesquisar repositórios que são associados a um tópico específico. Para obter mais informações, confira "Pesquisar repositórios". Também é possível pesquisar uma lista de tópicos no GitHub Enterprise Server. Para obter mais informações, confira "Pesquisar tópicos".

Ao criar um tópico:

  • Use letras em minúsculas, números e hifens.
  • Use 50 caracteres ou menos.
  • Adicione, no máximo, 20 tópicos.

Adicionar tópicos ao repositório

Observação: os nomes de tópico são sempre públicos, mesmo quando você cria o tópico dentro de um repositório privado.

  1. Em GitHub, acesse a página principal do repositório.

  2. No canto superior direito da página, à direita de "Sobre", clique em .

    Captura de tela do canto superior direito da página principal de um repositório. O botão "Editar metadados do repositório", mostrado como um ícone de engrenagem, é contornado em laranja.

  3. Em "Tópicos", comece a digitar o tópico que deseja adicionar ao repositório para ver um menu suspenso de todos os tópicos correspondentes. Clique no tópico que deseja adicionar ou continue digitando para criar um tópico.

    Captura de tela do campo "Tópicos" que mostra exemplos de tópicos: "documentação" e "trabalhos-com-o-codespaces". Uma "documentação" de tópicos "Sugeridos" é mostrada abaixo.

  4. Opcional: se houver tópicos "Sugeridos" exibidos no campo "Tópicos", clique em para adicionar ou para recusar o tópico sugerido.

  5. Depois de concluir a adição de tópicos, clique em Salvar alterações.