Por qué este sistema

Multidocs es el sistema de documentación que registra cómo trabaja el equipo. Esta página explica por qué necesitamos ese registro y por qué tomamos las decisiones técnicas que tomamos.

El problema que resuelve

Sin documentación centralizada, el conocimiento del equipo vive en la memoria de las personas y en convenciones implícitas que no se transmiten bien. Esto genera inconsistencias cuando el equipo crece, cuando hay rotación de personas o cuando alguien necesita recordar un proceso que no ejecuta con frecuencia.

Multidocs existe para que el conocimiento operativo del equipo sea explícito, accesible y actualizable. Los problemas concretos que ese conocimiento ayuda a resolver están en Qué resuelve este sistema.

Por qué MDX y no una wiki

Las wikis tienden a desactualizarse porque el ciclo de edición tiene fricción: hay que entrar a una plataforma separada, los cambios no pasan por revisión y no hay forma de ligar una actualización de documentación con el trabajo que la motivó.

Al usar archivos .mdx en el mismo repositorio del código, la documentación vive cerca del trabajo real y puede actualizarse en el mismo flujo que el código. El sistema de revisión via pull requests aplica el mismo estándar de calidad que el código: los cambios son visibles, auditables y requieren aprobación.

Decisiones de diseño

Este sistema prioriza la legibilidad y la navegación sobre la completitud. Es mejor tener páginas concisas y actualizadas que documentos exhaustivos que nadie lee. Cada página responde una pregunta concreta sobre cómo trabaja el equipo.