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
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:

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).
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.
Abra Configuración del proyecto → Hosting & Domain.
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-startedURL 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.
Need help? Visit our community forums or contact us.