Introducción (Astro Docs)
El motor de documentación de Lynx está construido sobre Astro, un framework moderno diseñado para la entrega de contenido web ultrarrápido con un enfoque en el rendimiento estático.
Objetivos del Sistema
Section titled “Objetivos del Sistema”Esta aplicación tiene como propósito centralizar el conocimiento técnico del ecosistema, proporcionando una experiencia de lectura fluida y herramientas de búsqueda avanzadas mediante Starlight.
Pila Tecnológica
Section titled “Pila Tecnológica”La infraestructura de documentación utiliza componentes líderes en la industria para garantizar una base extensible y profesional:
- Starlight: Framework de documentación que gestiona de forma nativa el i18n, la búsqueda y la navegación.
- Ion Theme: Sistema visual optimizado para la legibilidad de documentos técnicos extensos.
- Mermaid: Motor de diagramación que permite representar arquitecturas complejas mediante código.
- Sentry: Monitoreo y rastreo de errores en tiempo real para asegurar la disponibilidad de la documentación.
Diferencia con Storybook
Section titled “Diferencia con Storybook”Es fundamental distinguir el propósito de cada herramienta dentro del ecosistema:
[!NOTE] Mientras que el Storybook de @lynx/ui es la referencia visual para componentes atómicos de interfaz, Astro Docs es el recurso central para la arquitectura lógica, guías de implementación y estándares de ingeniería.
| Característica | Storybook (@lynx/ui) | Astro Docs (@lynx/astro) |
|---|---|---|
| Enfoque | UI / Frontend | Lógica / Arquitectura |
| Público | Desarrolladores Frontend | Ingenieros de Sistema |
| Interactividad | Sandbox de Componentes | Guías y Diagramas |
Para conocer cómo extender o mantener este sistema, consulte la sección de Arquitectura Lógica.