Síntese da documentação de usuário do EmDash CMS a partir de conversas reais
Um mapeamento documentado de perguntas recorrentes de usuários para documentos longos e entradas de FAQ, com prioridades de publicação e padrões editoriais.
Por que esta página existe
Esta página registra como conversas de suporte repetidas foram convertidas em ativos de documentação duráveis.
Mantém a estratégia de docs ligada ao atrito observado do usuário, não a suposições internas.
Pontos de dor de origem e posicionamento do documento
Ponto de dor 1: “Como devo começar a partir de um projeto EmDash vazio?”
Padrão observado: usuários pedem planejamento de pastas antes de escrever código e precisam de trade-offs de arquitetura desde o início.
Posicionamento: guia longo em docs/docs porque a resposta exige sequência, racional e análise de antipadrões.
Página mapeada:
docs/docs/emdash-cms-project-bootstrap-and-directory-layout.mdx
Ponto de dor 2: “Posso implantar no plano gratuito da Cloudflare e o que exatamente quebra?”
Padrão observado: usuários conseguem implantar parcialmente mas falham nos limites de recursos e na interpretação da linguagem de faturamento.
Posicionamento: dividido entre docs/docs e docs/faq:
- runbook de implantação pertence a docs longos
- esclarecimentos de faturamento e limites pertencem ao FAQ
Páginas mapeadas:
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
Ponto de dor 3: “Onde devo rodar estes comandos?”
Padrão observado: a correção do comando costuma estar ok, mas o contexto do diretório de trabalho está errado.
Posicionamento: FAQ, porque usuários precisam de diagnóstico rápido e regras de decisão curtas.
Página mapeada:
docs/faq/emdash-cms-deployment-command-context-faq.mdx
Ponto de dor 4: “Como verifico se o deploy realmente terminou?”
Padrão observado: usuários param no alcance da rota e perdem validação de admin/caminhos de dados.
Posicionamento: FAQ com formato de checklist e ordem rápida de triagem.
Página mapeada:
docs/faq/emdash-cms-deployment-verification-and-first-login-faq.mdx
Ponto de dor 5: “Para que serve Dynamic Workers de verdade?”
Padrão observado: o nome do recurso é entendido, mas as implicações do limite de segurança não.
Posicionamento: guia de arquitetura em docs/docs, porque é explicação de modelo, não frase única.
Página mapeada:
docs/docs/emdash-cms-plugin-runtime-and-security-model.mdx
Ordem de publicação e racional
Sequência de release 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- referências restantes de arquitetura e self-hosted
Princípio de ordenação:
- publicar primeiro tópicos de maior confusão e maior carga de suporte
- depois publicar guias completos de execução
- depois publicar referências profundas de arquitetura
Regras editoriais para manter a documentação crível
Use estes padrões para adições futuras:
- liderar com decisão e limite, depois fornecer mecanismo
- incluir sinais de sucesso e de falha para cada operação
- fornecer caminho de rollback ou alternativa para cada passo de alto impacto
- evitar adjetivos abstratos salvo quando atados a critérios mensuráveis
- escrever para operadores sob pressão de tempo, não para tom de marketing
Rotina de manutenção
Revise este mapeamento mensalmente com três entradas:
- principais perguntas repetidas de suporte
- padrões de deploy falho a partir de relatórios de usuários
- páginas de documentação com muitas saídas e baixo feedback de conclusão
Quando uma pergunta aparecer no suporte mais de duas vezes em um mês, melhore diagnósticos na página existente ou adicione uma entrada de FAQ direcionada.