Un artículo se puede definir como relevante para uno o varios temas teniendo esos temas enumerados en el texto preliminar del artículo. Por ejemplo:
---
title: "Managing branches in your repository"
topics:
- "GitHub"
- "Git"
- "Repositories"
---
Para más información sobre cómo agregar temas a un artículo, consulte "Usar el texto preliminar de YAML". Para obtener una lista de todos los temas permitidos, consulte allowed-topics
.
Temas para todos los tipos de contenido
- Usa nombres como temas.
- Los temas ayudan a los usuarios a agrupar contenido de forma significativa.
- Cuando sea posible, usa temas más específicos que sean relevantes, no solo temas amplios. Por ejemplo,
REST
oGraphQL
en lugar de soloAPI
. - Asegúrate de que los temas de artículos similares sean coherentes para que los usuarios que filtren por un tema obtengan todos los artículos pertinentes. Por ejemplo, todos los artículos sobre CI deben tener el tema
CI
y temas más específicos. - Evita temas ambiguos. Por ejemplo,
Actions
puede que no sea un tema útil dentro del producto Actions, ya que podría hacer referencia al producto GitHub Actions o al elemento del producto denominado acción.
- Cuando sea posible, usa temas más específicos que sean relevantes, no solo temas amplios. Por ejemplo,
- Los temas agregan valor (no replican) más allá del título, el tipo o la categoría del artículo.
- Por ejemplo, dentro del producto Actions,
Actions
no agrega ningún valor, porque alguien que esté en esta sección de la documentación ya sabe que está consultando la documentación de Actions.
- Por ejemplo, dentro del producto Actions,
- Usa
Fundamentals
para artículos relacionados con los conceptos básicos de un área de producto.- Usa
Fundamentals
en un artículo como "Introduction to GitHub Actions". - Evita
Actions
en un artículo como "Introduction to GitHub Actions".
- Usa
- Se pueden usar abreviaturas reconocidas habitualmente, pero deben evitarse las abreviaturas poco conocidas o ambiguas.
- Usa
CI
en lugar deContinuous integration
. - Evita el uso de
AS
en lugar deAdvanced Security
.
- Usa
- Usa los formatos cortos de los nombres de producto de GitHub.
- Usa
Actions
en lugar deGitHub Actions
.
- Usa
Lista de comprobación para la elección de temas
Usa estas preguntas para ayudarte a elegir temas para un artículo. No todos los artículos tendrán un tema para cada elemento de la lista de comprobación.
- ¿Cuál es la característica o el área del producto?
- Ejemplo:
Enterprise
. ¿El artículo es sobre una subcaracterística? (a menos que el nombre del producto coincida con el nombre de la característica) - Ejemplo:
Dependabot
- Ejemplo:
- ¿La característica forma parte de un programa restringido?
- Ejemplo:
Advanced Security
- Ejemplo:
- ¿Sobre qué elemento de la característica o del producto es el artículo?
- Ejemplo:
Organizations
- Ejemplo:
- ¿Cuál es la finalidad general del artículo?
- Ejemplo:
Permissions
- Ejemplo:
- ¿Qué lenguajes de programación, administradores de paquetes o ecosistemas aborda explícitamente el artículo? Incluye estos temas únicamente si agregan valor a alguien que filtre los documentos, no solo porque un artículo enumera los lenguajes, administradores de paquetes o ecosistemas admitidos.
- Ejemplo:
Ruby
- Ejemplo: