En esta carpeta docs/ se agrupan guías, recursos técnicos y registros de decisiones del proyecto.
¿Es tu primera vez? Comienza en ARCHITECTURE.md para entender principios. ¿Necesitas hacer algo específico? Busca en la sección temática abajo. Cada documento se auto-referencia a sus documentos relacionados.
- CONTRIBUTING.md — Guía de contribución y convenciones de desarrollo
- FLOWS.md — Flujos E2E: Page Objects (UI) y endpoints (API)
- GISCUS.md — Integración de comentarios con Giscus
- DEVELOPMENT_WORKFLOW.md — Flujo visual de desarrollo y validación pre-PR
- TESTING_STRATEGY.md — Estrategia de pruebas (E2E con Playwright, unitarias con Vitest)
- COMMON_AI_MISTAKES.md — 6 patrones reales de errores que la IA ha cometido y cómo evitarlos
- CONTENT_POLICY.md — Convenciones sobre el contenido del sitio
- MARKDOWN_VALIDATION.md — Validación de Markdown (linting y reglas de formato)
- UPGRADE.md — Guía de actualización
- DEVCONTAINER.md — Configuración de Dev Container para desarrollo consistente
- E2E_PARAMS.md — Parámetros y configuración para tests E2E
- adr/ — Carpeta que contiene todas las Architecture Decision Records
- adr/README.md — Índice de ADRs, convenciones y procedimientos
- images/ — Imágenes referenciadas por documentos (capturas, diagramas, etc.)
- Mantén las imágenes organizadas dentro de
docs/images/y utiliza rutas relativas (./images/nombre.png) desde los archivos dedocs/. - Los ADRs viven en
adr/y poseen su propio README de índice. - Actualiza este README si agregas nuevo contenido para facilitar la navegación.