EmDash CMS – Síntesis de documentación de usuario a partir de conversaciones reales
Mapeo documentado de preguntas recurrentes de usuarios a documentos largos y entradas FAQ, con prioridades de publicación y estándares editoriales.
Por qué existe esta página
Registra cómo conversaciones de soporte repetidas se convirtieron en activos de documentación duraderos.
Mantiene la estrategia de documentación ligada a la fricción observada de usuarios, no a supuestos internos.
Puntos de dolor y ubicación del documento
Punto 1: «¿Cómo empiezo desde un proyecto EmDash vacío?»
Patrón observado: los usuarios piden planificación de carpetas antes de escribir código y necesitan trade-offs de arquitectura desde el principio.
Ubicación: guía larga en docs/docs porque la respuesta requiere secuencia, razón y análisis de anti-patrones.
Página asignada:
docs/docs/emdash-cms-project-bootstrap-and-directory-layout.mdx
Punto 2: «¿Puedo desplegar en el plan Free de Cloudflare y qué falla exactamente?»
Patrón observado: los usuarios despliegan parcialmente pero fallan en límites de funciones e interpretación del lenguaje de facturación.
Ubicación: dividido entre docs/docs y docs/faq:
- el runbook de despliegue pertenece a documentos largos
- facturación y aclaraciones de límites pertenecen a FAQ
Páginas asignadas:
docs/docs/emdash-cms-cloudflare-free-tier-production-playbook.mdxdocs/faq/emdash-cms-cloudflare-pricing-and-billing-faq.mdxdocs/faq/emdash-cms-cloudflare-free-plan-limitations-faq.mdx
Punto 3: «¿Dónde debo ejecutar estos comandos?»
Patrón observado: los comandos suelen ser correctos, el contexto del directorio de trabajo no.
Ubicación: FAQ, porque los usuarios necesitan diagnóstico rápido y reglas de decisión cortas.
Página asignada:
docs/faq/emdash-cms-deployment-command-context-faq.mdx
Punto 4: «¿Cómo verifico que el despliegue está realmente hecho?»
Patrón observado: los usuarios se detienen en el alcance de rutas y omiten validación de admin/rutas de datos.
Ubicación: FAQ con formato de lista de comprobación y orden de triage rápido.
Página asignada:
docs/faq/emdash-cms-deployment-verification-and-first-login-faq.mdx
Punto 5: «¿Para qué sirve realmente Dynamic Workers?»
Patrón observado: el nombre se entiende, las implicaciones de límites de seguridad no.
Ubicación: guía de arquitectura en docs/docs, porque es explicación de modelo, no una línea.
Página asignada:
docs/docs/emdash-cms-plugin-runtime-and-security-model.mdx
Orden de publicación y razón
Secuencia recomendada:
docs/faq/emdash-cms-cloudflare-pricing-and-billing-faq.mdxdocs/docs/emdash-cms-cloudflare-free-tier-production-playbook.mdxdocs/faq/emdash-cms-cloudflare-free-plan-limitations-faq.mdxdocs/docs/emdash-cms-project-bootstrap-and-directory-layout.mdx- referencias restantes de arquitectura y self-hosted
Principio de orden:
- publicar primero los temas con mayor confusión y carga de soporte
- luego guías de ejecución completas
- luego referencias profundas de arquitectura
Reglas editoriales para mantener documentación creíble
Estándares para futuras adiciones:
- empezar con decisión y límite, luego mecanismo
- incluir señales de éxito y fallo para cada operación
- proporcionar vía de rollback o alternativa para cada paso de alto impacto
- evitar adjetivos abstractos salvo que estén ligados a criterios medibles
- escribir para operadores bajo presión de tiempo, no en tono de marketing
Rutina de mantenimiento
Revisa este mapeo mensualmente con tres entradas:
- principales preguntas de soporte repetidas
- patrones de despliegue fallidos de informes de usuarios
- páginas de documentación con muchas salidas y poco feedback de finalización
Cuando una pregunta aparece en soporte más de dos veces en un mes, mejora el diagnóstico de la página existente o añade una entrada FAQ dirigida.