실제 대화에서 정리한 EmDash CMS 사용자 문서
반복되는 사용자 질문을 장문 문서 및 FAQ 항목에 매핑한 기록과, 게시 우선순위·편집 기준을 담습니다.
이 페이지가 있는 이유
이 페이지는 반복 지원 대화를 지속 가능한 문서 자산으로 바꾼 방식을 기록합니다.
문서 전략을 내부 가정이 아니라 관찰된 사용자 마찰에 묶어 둡니다.
출처별 pain point와 문서 배치
Pain point 1: “빈 EmDash 프로젝트에서 어떻게 시작해야 하나요?”
관찰된 패턴: 사용자는 코드를 쓰기 전에 폴더 계획을 요청하고, 앞서 아키텍처 트레이드오프가 필요합니다.
배치: 답에 순서, 근거, 안티패턴 분석이 필요하므로 docs/docs의 장문 가이드.
매핑된 페이지:
docs/docs/emdash-cms-project-bootstrap-and-directory-layout.mdx
Pain point 2: “Cloudflare 무료 플랜에 배포할 수 있고, 정확히 무엇이 깨지나요?”
관찰된 패턴: 사용자는 부분 배포는 되지만 기능 경계와 결제 문구 해석에서 실패합니다.
배치: docs/docs와 docs/faq로 분리:
- 배포 런북은 장문 문서
- 결제 및 경계 명확화는 FAQ
매핑된 페이지:
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
Pain point 3: “이 명령은 어디서 실행해야 하나요?”
관찰된 패턴: 명령 자체는 맞는데 작업 디렉터리 맥락이 틀립니다.
배치: 빠른 진단과 짧은 결정 규칙이 필요하므로 FAQ.
매핑된 페이지:
docs/faq/emdash-cms-deployment-command-context-faq.mdx
Pain point 4: “배포가 정말 끝났는지 어떻게 확인하나요?”
관찰된 패턴: 사용자는 라우트 도달에서 멈추고 관리자·데이터 경로 검증을 놓칩니다.
배치: 체크리스트 형식과 빠른 트리아지 순서가 있는 FAQ.
매핑된 페이지:
docs/faq/emdash-cms-deployment-verification-and-first-login-faq.mdx
Pain point 5: “Dynamic Workers는 실제로 무엇을 위한 건가요?”
관찰된 패턴: 기능 이름은 이해되지만 보안 경계 함의는 이해되지 않습니다.
배치: 모델 설명이므로 한 줄이 아니라 docs/docs의 아키텍처 가이드.
매핑된 페이지:
docs/docs/emdash-cms-plugin-runtime-and-security-model.mdx
게시 순서와 근거
권장 공개 순서:
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- 나머지 아키텍처 및 셀프호스트 참고 자료
순서 원칙:
- 혼란·지원 부하가 가장 큰 주제를 먼저 게시
- 그다음 완전한 실행 가이드
- 그다음 깊은 아키텍처 참고
문서 신뢰도를 유지하는 편집 규칙
향후 추가에 다음 기준을 사용하세요.
- 결정과 경계를 먼저, 그다음 메커니즘
- 각 작업에 성공 신호와 실패 신호 포함
- 영향이 큰 단계마다 롤백 또는 대체 경로 제공
- 측정 가능한 기준에 묶이지 않은 추상 형용사 지양
- 마케팅 톤이 아니라 시간 압박 아래 운영자를 위해 작성
유지 관리 루틴
다음 세 가지 입력으로 이 매핑을 매월 검토하세요.
- 반복 지원 질문 상위
- 사용자 보고의 배포 실패 패턴
- 이탈이 높고 완료 피드백이 낮은 문서 페이지
한 달에 두 번 이상 지원에 나오는 질문이면 기존 페이지 진단을 개선하거나 타깃 FAQ 항목을 추가하세요.