Clasificar tu repositorio con temas

Para ayudar a otras personas a buscar y contribuir en tu proyecto, puedes agregar temas a tu repositorio relacionados con el fin previsto de tu proyecto, área temática, grupos de afinidad u otras cualidades importantes.

En este artículo

Acerca de los temas

En el caso de los temas, puedes explorar repositorios en un área temática particular, buscar proyectos a los cuales contribuir y descubrir nuevas soluciones para un problema específico. Los temas aparecen en la página principal de un repositorio. Puede hacer clic en el nombre de un tema para ver temas relacionados y una lista de otros repositorios clasificados con ese tema.

Captura de pantalla del repositorio github/docs. En la barra lateral derecha, hay tres temas resaltados en naranja oscuro: "docs", "hacktoberfest" y "works-with-codespaces".

Para examinar los temas más usados, ve a github.com/topics/.

Puede contribuir al conjunto de temas destacados de GitHub en el repositorio github/explore.

Los administradores del repositorio pueden agregar los temas que deseen a un repositorio. Entre los temas útiles para clasificar un repositorio se incluyen los fines previstos, áreas temáticas, comunidad o idioma. Además, GitHub analiza el contenido de los repositorios públicos y genera temas sugeridos que los administradores del repositorio pueden aceptar o rechazar. El contenido del repositorio privado no se analiza y no recibe sugerencias de tema.

Los repositorios públicos y privados pueden tener temas, aunque solo verás los repositorios privados a los que puedes acceder en los resultados de la búsqueda de temas.

Puedes buscar los repositorios que están asociados con un tema en particular. Para más información, consulta Buscar repositorios. También puedes buscar un listado de temas en GitHub. Para más información, consulta Buscar temas.

Al crear un tema:

  • Usa letras minúsculas, números y guiones
  • Usa 50 caracteres o menos
  • Agrega no más de 20 temas

Agregar temas a tu repositorio

Note

Los nombres de los temas siempre son públicos, aunque el tema se cree desde un repositorio privado.

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. En la esquina superior derecha de la página, a la derecha de "Acerca de", haz clic en .

    Captura de pantalla de la parte superior derecha de la página principal de un repositorio. El botón "Editar metadatos del repositorio", que se muestra como icono de engranaje, tiene un contorno naranja.

  3. En "Temas", empieza a escribir el tema que quieras agregar al repositorio para mostrar un menú desplegable de los temas coincidentes. Haz clic en el tema que quieras agregar, o bien sigue escribiendo para crear un tema.

    Captura de pantalla del campo "Temas" en el que se muestran temas de ejemplo: "docs" y "works-with-codespaces". Debajo se muestra un tema de "documentación" "Sugerido".

  4. Opcional, si se muestran temas "Sugeridos" en el campo "Temas", haz clic en para agregarlos, o bien en para rechazar el tema sugerido.

  5. Cuando haya terminado de agregar temas, haga clic en Guardar cambios.