Sintesi della documentazione utenti Emdash CMS da conversazioni reali
Mappatura documentata delle domande ricorrenti degli utenti verso guide lunghe e FAQ, con priorità di pubblicazione e standard editoriali.
Perché esiste questa pagina
Questa pagina registra come conversazioni di supporto ripetute siano state convertite in asset documentali durevoli.
Mantiene la strategia documentale legata alle frizioni osservate dagli utenti, non ad assunzioni interne.
Punti di dolore all’origine e collocazione dei documenti
Punto di dolore 1: “Come dovrei iniziare da un progetto EmDash vuoto?”
Pattern osservato: gli utenti chiedono pianificazione delle cartelle prima di scrivere codice e vogliono vedere in anticipo i trade-off architetturali.
Collocazione: guida long-form in docs/docs perché la risposta richiede sequenza, razionale e analisi degli anti-pattern.
Pagina mappata:
docs/docs/emdash-cms-project-bootstrap-and-directory-layout.mdx
Punto di dolore 2: “Posso distribuire su Cloudflare Free e cosa si rompe esattamente?”
Pattern osservato: gli utenti riescono a fare deploy parziale ma falliscono sui confini funzionali e sull’interpretazione del linguaggio di billing.
Collocazione: divisa tra docs/docs e docs/faq:
- il runbook di deploy appartiene alle guide long-form
- chiarimenti su billing e confini appartengono alle FAQ
Pagine mappate:
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 di dolore 3: “Dove devo eseguire questi comandi?”
Pattern osservato: i comandi sono spesso corretti, ma il contesto della working directory è sbagliato.
Collocazione: FAQ, perché gli utenti hanno bisogno di diagnostica veloce e regole decisionali brevi.
Pagina mappata:
docs/faq/emdash-cms-deployment-command-context-faq.mdx
Punto di dolore 4: “Come verifico che un deploy sia davvero completato?”
Pattern osservato: gli utenti si fermano alla raggiungibilità delle route e saltano la validazione admin/percorsi dati.
Collocazione: FAQ in formato checklist con ordine di triage rapido.
Pagina mappata:
docs/faq/emdash-cms-deployment-verification-and-first-login-faq.mdx
Punto di dolore 5: “A cosa serve davvero Dynamic Workers?”
Pattern osservato: il nome della funzionalità è compreso, ma non le implicazioni sui confini di sicurezza.
Collocazione: guida architetturale in docs/docs, perché questa è una spiegazione di modello, non una risposta in una riga.
Pagina mappata:
docs/docs/emdash-cms-plugin-runtime-and-security-model.mdx
Ordine di pubblicazione e razionale
Sequenza di rilascio consigliata:
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- riferimenti rimanenti su architettura e self-hosted
Principio di ordinamento:
- pubblica prima i temi con maggiore confusione e maggiore carico di supporto
- poi pubblica le guide di esecuzione complete
- poi pubblica i riferimenti architetturali più approfonditi
Regole editoriali per mantenere credibile la documentazione
Usa questi standard per le aggiunte future:
- inizia da decisione e confine, poi spiega il meccanismo
- includi segnali di successo e di errore per ogni operazione
- fornisci un percorso di rollback o fallback per ogni passaggio ad alto impatto
- evita aggettivi astratti se non legati a criteri misurabili
- scrivi per operatori sotto pressione temporale, non con tono marketing
Routine di manutenzione
Rivedi questa mappatura ogni mese usando tre input:
- domande di supporto più ripetute
- pattern di deploy falliti dai report utenti
- pagine documentazione con alto tasso di uscita e basso feedback di completamento
Quando una domanda compare nel supporto più di due volte in un mese, migliora la diagnostica della pagina esistente oppure aggiungi una voce FAQ mirata.