SEO

La búsqueda es una de las principales vías por las que los lectores descubren la documentación. DeveloperHub está diseñado para ser rastreable e indexable de forma predeterminada, con valores predeterminados sensatos 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 apto para bots para la indexación y las herramientas de SEO

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

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 redactan 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 de forma global 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 Page Info (barra lateral derecha), en la pestaña Settings.

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

También puedes generar una descripción desde Page Info → Settings → AI Generate. Para más detalles, consulta AI SEO Helper.

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 endpoints estándar de descubrimiento en la raíz de tu sitio de documentación:

• /robots.txt

• /sitemap.xml

• /sitemap.txt

Dónde encontrarlos depende de cómo esté alojada tu 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ás alojando bajo un sitio web existente, los endpoints de sitemap y robots están bajo la ruta base de la documentación en el dominio personalizado (y también están disponibles en el subdominio).

Search Console (dominios personalizados)

Si usas un dominio personalizado, crea 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 tu documentación.

Ajustes del proyecto que afectan al SEO

Estos ajustes se encuentran en Project Settings 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 quieres que la documentación sea visible en los motores de búsqueda, desactiva Allow search-engine indexing en Project Settings (Hosting).

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

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

Si quieres que las URL canónicas incluyan el slug de la versión, activa Canonicalize Short URL Form en Project Settings (Hosting).

Si quieres que solo se indexe la versión predeterminada, activa Only Index Default Version en Project Settings (Hosting).

Meta etiquetas adicionales

Si necesitas añadir etiquetas de verificación personalizadas u otras meta etiquetas relacionadas con el SEO, consulta Etiquetas HEAD personalizadas.

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 distinta 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 un bot ve una página, añade ?_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 tu software de SEO parece no estar admitido, configúralo para que use un user agent de araña conocido como googlebot, o contáctanos para que añadamos compatibilidad.

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

Consulta el consejo de solución de problemas anterior. Para ver el contenido renderizado, puedes:

• Usar las DevTools de tu 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 usas middleware (por ejemplo, Cloudflare) delante del sitio de documentación, puede interferir en el servicio de páginas renderizadas para bots. Desactiva el middleware para el sitio de documentación si es posible, o configúralo para que conserve el comportamiento de renderizado para bots.

Obtienes un 403 o un resultado inesperado del bot

Si usas un firewall, puede bloquear nuestro renderizador de SEO. Añade 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 sirve respuestas distintas según si el user agent es un lector o un bot.

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