SEO

La búsqueda es una de las principales formas en que los lectores descubren la documentación. DeveloperHub está diseñado para ser rastreable e indexable de forma predeterminada, con valores predeterminados razonables y un pequeño conjunto de controles a nivel de proyecto.

Optimizado para SEO

Los portales de documentación de DeveloperHub están optimizados para SEO de forma predeterminada:

  • URL limpias y estables

  • Estructura semántica y encabezados

  • Compatibilidad con URL canónicas para reducir la duplicación (especialmente con el control de versiones)

  • Renderizado adaptado a bots para la indexación y las herramientas de SEO

Información

Almacenamos en caché las páginas renderizadas para bots cada 7 días para servirlas rápidamente a los motores de búsqueda y al software de SEO.

Nuestras páginas suelen obtener puntuaciones altas en las auditorías SEO de Google Lighthouse:

Prueba SEO de Lighthouse de Google en nuestras páginas

Estructura de la página y encabezados

Las páginas usan encabezados semánticos:

  • El título de la página es el H1.

  • Los demás encabezados (H2, H3, etc.) se usan tal como se crean en el editor.

Esto ayuda a los motores de búsqueda a entender la jerarquía del contenido.

Títulos, descripciones y vistas previas en redes sociales

Esta sección cubre las preguntas más habituales sobre cómo se obtienen los metadatos y qué se puede personalizar.

Etiqueta de título (título de la pestaña del navegador)

La etiqueta <title> se controla globalmente mediante seo.titleFormats en Configuración avanzada.

De forma predeterminada, usa el formato:

  • %page% - %project%

Meta descripción

Cada página puede reemplazar su meta descripción desde Información de la página (barra lateral derecha), en la pestaña Configuración.

De forma predeterminada, la meta descripción se toma del primer párrafo de la página.

También puede generar una descripción desde Información de la página → Configuración → Generar con IA. Para más detalles, consulte Asistente de SEO con IA.

Imagen de vista previa social (imagen Open Graph)

Cuando se comparte un enlace de la documentación (por ejemplo, en Slack), la imagen de vista previa se determina automáticamente:

  • Si la página contiene una imagen, se usa la primera imagen de la página.

  • Si la página no contiene imágenes, se usa el logotipo del proyecto.


Sitemap y robots.txt

DeveloperHub proporciona los endpoints estándar de descubrimiento en la raíz de su sitio de documentación:

  • /robots.txt

  • /sitemap.xml

  • /sitemap.txt

Dónde encontrarlos depende de cómo esté alojada su documentación. Ejemplos:

  • Dominio personalizado sin ruta base:

    • https://<custom-domain>/sitemap.xml

  • Dominio personalizado con ruta base:

    • https://<custom-domain>/<base-path>/sitemap.xml

  • Subdominio de DeveloperHub:

    • https://<subdomain>.developerhub.io/sitemap.xml

Si está alojando bajo un sitio web existente, los endpoints de sitemap y robots se encuentran bajo la ruta base de la documentación en el dominio personalizado (y también están disponibles en el subdominio).

Información

Los sitemaps se generan cada 6 horas.

Search Console (dominios personalizados)

Si usa un dominio personalizado, cree una propiedad en la Search Console de un motor de búsqueda (por ejemplo, Google Search Console). Esto proporciona diagnósticos de rastreo, estado de indexación y rendimiento de consultas para su documentación.

Ajustes del proyecto que afectan al SEO

Estos ajustes se encuentran en la configuración del proyecto y son los principales interruptores que afectan a la indexación y al comportamiento canónico.

Activar o desactivar la indexación en buscadores

Si no desea que la documentación sea visible en los motores de búsqueda, desactive Allow search-engine indexing en la configuración del proyecto (Hosting & Domain).

Estrategia de URL canónica para documentación con versiones

De forma predeterminada, DeveloperHub trata la URL corta (sin el slug de versión) como la URL canónica.

Si desea que las URL canónicas incluyan el slug de versión, active Canonicalize Short URL Form en la configuración del proyecto (Hosting & Domain).

Si desea que solo se indexe la versión predeterminada, active Only Index Default Version en la configuración del proyecto (Hosting & Domain).

Metaetiquetas adicionales

Si necesita añadir etiquetas de verificación personalizadas o metaetiquetas adicionales relacionadas con el SEO, consulte Etiquetas HEAD personalizadas.

Informe de SEO

El informe de SEO le permite revisar el SEO de las páginas, como los títulos y las meta descripciones, de todas sus páginas a la vez en lugar de abrirlas una por una.

  1. Abra Configuración del proyecto → Hosting & Domain.

  2. En la tarjeta Informe de SEO, haga clic en Descargar junto a Este proyecto, o junto a Todos los proyectos para todos los proyectos de la organización de los que sea administrador.

La descarga es un zip de hojas de cálculo: una por cada proyecto con la lista de sus páginas, y Project settings con los ajustes de SEO de cada proyecto. Para cada página puede ver la etiqueta de título y la meta descripción que reciben los motores de búsqueda, si la página se puede indexar y, si no, por qué, y si está en el sitemap y en llms.txt.

Solución de problemas

El software de SEO muestra que todas las páginas están vacías

DeveloperHub renderiza las páginas de forma diferente para lectores y para bots. Los bots incluyen arañas de indexación, bots de verificación de sitios, arañas de software de SEO y agentes de IA.

Para ver cómo ve un bot una página, añada ?_escaped_fragment_= al final de la URL.

Ejemplo:

  • URL del lector: https://docs.developerhub.io/support-center/getting-started

  • URL del bot: https://docs.developerhub.io/support-center/getting-started?_escaped_fragment_=.

Esto no perjudica al SEO. Garantiza que los rastreadores reciban una instantánea HTML completamente renderizada.

Admitimos los principales motores de búsqueda y las herramientas de SEO habituales. Si su software de SEO parece no ser compatible, configúrelo para que use un user agent de araña conocido, como googlebot, o contáctenos para añadir compatibilidad.

Al inspeccionar el código fuente de la página, esta aparece vacía

Consulte el consejo de solución de problemas anterior. Para ver el contenido renderizado, puede:

  • Usar las DevTools de su navegador e inspeccionar el DOM en la pestaña Elements, o

  • Añadir ?_escaped_fragment_= a la URL y luego ver el código fuente.

El motor de búsqueda informa de errores 404

Si usa middleware (por ejemplo, Cloudflare) delante del sitio de documentación, puede interferir en el servicio de páginas renderizadas para bots. Desactive el middleware para el sitio de documentación si es posible, o configúrelo para preservar el comportamiento de renderizado para bots.

Obtiene un 403 o un resultado inesperado del bot

Si usa un firewall, puede bloquear nuestro renderizador de SEO. Añada a la lista de permitidos el user agent DeveloperHub.io SSR.

El motor de búsqueda muestra "Unable to Load Project"

Esto puede ocurrir cuando el middleware almacena en caché la documentación sin variar según el user agent. DeveloperHub ofrece respuestas diferentes según si el user agent es un lector o un bot.

Configure la caché para que varíe según el user agent, o desactive la caché para el sitio de documentación.

  Última actualización