Skip to main content

Hacer que el contenido se pueda encontrar en la búsqueda

Sigue estos procedimientos recomendados de SEO para ayudar a los usuarios a encontrar documentación de GitHub mediante motores de búsqueda.

Acerca de la optimización del motor de búsqueda (SEO)

La optimización del motor de búsqueda (SEO) es la práctica de obtener visibilidad del contenido web en los resultados del motor de búsqueda, como los de Google y Bing. La búsqueda de Google es la referencia principal a GitHub Docs y el punto de entrada más común para nuestros usuarios.

Podemos planear y escribir nuestro contenido para mejorar SEO. Un buen SEO mejora la experiencia de las personas que buscan documentación porque hace que sea más probable que encuentren la información que buscan utilizando sus términos de búsqueda preferidos.

Procedimientos recomendados para contenido SEO

Un buen SEO requiere el contenido de planificación para audiencias específicas y estar atento a las palabras que usan para buscar. Sigue estos procedimientos recomendados para mejorar el SEO de un artículo.

Selecciona un público objetivo

Comprende y escribe en la audiencia específica para el contenido: desarrolladores, administradores o estudiantes de código. Esto le ayuda a:

  • Usa palabras que usen los lectores.
  • Haz que el contenido sea relevante para tus necesidades y tareas.
  • Proporciona la cantidad correcta de información en segundo plano y contexto.

Responde a la intención de búsqueda

Crea contenido en torno a la intención de búsqueda: la tarea, la pregunta o el problema que impulsa a un miembro de la audiencia de destino para buscar información en línea.

  • Lleva a cabo una investigación de intenciones de búsqueda. Por ejemplo, analiza las páginas de resultados del motor de búsqueda (SERP) para las consultas pertinentes.
  • Comprende las necesidades del usuario. Usa varios recursos, como comentarios de clientes, entrevistas de usuario y métricas.

Usa un lenguaje claro

Sigue las instrucciones de Procedimientos recomendados para documentos de GitHub, entre las que se incluyen:

  • Asegúrate de que cada artículo tiene un tema claro y discreto.
  • Coloca primero el contenido de prioridad más alta en un artículo.
  • Estructura artículos con encabezados claros.
  • Edita el contenido para mantener la coherencia después de Guía de estilo.

Incorpora palabras clave

Incorpora palabras clave o términos de búsqueda principales utilizados por tu público en la copia de página y los metadatos. Por ejemplo, si estás escribiendo sobre "facturación", pero tu audiencia usa principalmente "coste" y "pago", usa esos términos en su lugar.

Google y Bing ofrecen herramientas de investigación de palabras clave para ayudarte a detectar palabras clave relevantes. El equipo de Docs también consulta los datos de Google Search Console para comprender qué términos de búsqueda conducen a páginas de GitHub Docs.

Incluye metadatos

Usa metadatos completos en la instancia de frontmatter. Para ver los valores disponibles, consulta Usar el texto preliminar de YAML.

En GitHub Docs, el elemento intro se muestra como un subtítulo en la página y actúa como la descripción de los metadatos HTML. El título del artículo actúa como título de página HTML. Para un buen SEO:

  • Escribe el título y intro para que sea complementario y enriquecido con palabras clave. Ten en cuenta cómo se representarán en la investigación.
  • Acompaña todas las imágenes con texto alternativo enriquecido con palabras clave, que también son metadatos utilizados por los motores de búsqueda. Consulta Texto alternativo en la Guía de estilo de GitHub Docs.

Vincula de forma prudente otras páginas relevantes para tareas en GitHub Docs y sitios del mismo nivel de alta calidad, siguiendo Vínculos en la Guía de estilo de GitHub Docs.

Asegúrate de que los vínculos entrantes no se interrumpan manteniendo cuidadosamente los redireccionamientos.

Mantener la precisión

Asegúrate de que el contenido está libre de errores de contenido, ortografía y estilo. Audita el contenido periódicamente para eliminar errores como vínculos que no funcionan y retirar contenido innecesario. Consulta Configuración de redireccionamientos.