Skip to main content

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.

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 ver tópicos relacionados e uma lista de outros repositórios classificados 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 procurar os tópicos mais usados, acesse https://github.com/topics/.

Você pode contribuir para o conjunto de tópicos em destaque do GitHub no repositório github/explore.

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. Além disso, o GitHub analisa o conteúdo do repositório público e gera tópicos sugeridos que os administradores do repositório podem aceitar ou rejeitar. O conteúdo do repositório privado não é analisado e não recebe sugestões de tópico.

Os repositórios público e privado 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. Para obter mais informações, confira "Pesquisar tópicos".

Ao criar um tópico:

  • use letras minúsculas, números e hifens.
  • usar 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. No GitHub.com, navegue até 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.