Sample — Artículo largo

Introducción

Este sample simula un artículo de guía con varios niveles de encabezado, párrafos largos y bloques anidados. Úsalo para comprobar que el ancho de lectura, interlineado y contraste siguen siendo cómodos tras varios scrolls.

Nota: Los datos siguientes son ficticios; solo validan el layout.

Arquitectura recomendada

1. Frontend — Astro + Starlight con tema Page.
2. API — Edge functions o Workers según tráfico.
3. Datos — Postgres gestionado (Neon u homólogo).
4. Observabilidad — Logs estructurados y alertas por umbral.

Subsección: decisiones de diseño

Cuando un equipo crece, la documentación deja de ser un PDF estático y pasa a vivir junto al código. Centralizar guías, referencias de API y changelog en un solo sitio reduce fricción entre diseño, producto e ingeniería.

Ventajas Trade-offs

• Una URL por versión del producto
• Búsqueda integrada de Starlight
• Componentes reutilizables en MDX

• Curva inicial de Starlight + MDX
• Build más pesada con muchas páginas
• Coordinar traducciones si hay i18n

Ejemplo de configuración

// astro.config.ts (extracto)
export default defineConfig({
  integrations: [
    starlight({
      customCss: ['./src/styles/crlabz.css'],
      plugins: [pagePlugin({ navigation: [...] })],
    }),
  ],
});

Tabla comparativa

Criterio	Docs estáticas	Docs en repo
Versionado	Manual	Git
Preview PR	No	Sí (CI)
Componentes UI	Limitado	MDX completo

Tip de revisión

Cambia entre modo claro y oscuro mientras lees este bloque: el código expresivo y las tablas deben mantener bordes legibles.

Conclusión

Si el artículo se lee bien de principio a fin, el tema está listo para contenido real de clientes y productos internos.