사용 가이드

이 사이트를 EmDash 문서, 마이그레이션 콘텐츠, 플러그인, 템플릿, 제품 업데이트를 위한 발행 시스템으로 활용하세요.

이 웹사이트가 해야 할 일

emdashcmseverything.com은 일반적인 랜딩 페이지처럼 동작하면 안 됩니다. EmDash 생태계를 위한 공개 지식 허브이자 배포 레이어로 작동해야 합니다.

즉, 하나의 일관된 시스템 안에서 여러 콘텐츠 작업을 함께 수행해야 합니다.

  • EmDash가 무엇인지 설명하기
  • EmDash가 어떻게 동작하는지 알려주기
  • 어디에 적합한지 보여주기
  • 플러그인과 템플릿 발행하기
  • WordPress 마이그레이션 안내하기
  • 제품 진행 상황과 릴리스 공지하기

권장 정보 구조

현재 구조는 이 운영 모델을 지원하도록 설계되어 있습니다.

  • docs/docs: 장기적으로 유지되는 문서
  • docs/use-cases: 시나리오 중심 도입 콘텐츠
  • docs/plugins: 플러그인 디렉터리 항목
  • docs/templates: 템플릿 디렉터리 항목
  • docs/faq: 업데이트, 튜토리얼, 에디토리얼 콘텐츠

이 방식은 모든 내용을 단일 마케팅 홈페이지에 몰아넣거나 제품 정보를 프레임워크 컴포넌트 안에 숨기는 것보다 훨씬 적합합니다.

섹션별 사용 방법

Docs

이 섹션에는 오래 유지되고 의도가 분명한 콘텐츠를 배치하세요.

  • 시작하기
  • 기능 설명
  • 배포 노트
  • 아키텍처 개요
  • FAQ

이 페이지들은 도입 전후에 사용자가 실제로 묻는 질문에 답해야 합니다.

Use Cases

이 섹션은 제품 기능을 구매자 관점의 맥락으로 바꿔 설명할 때 사용합니다. EmDash는 다음과 같은 용도에 맞춘 형태로 제시할 때 더 이해하기 쉽습니다.

  • 에디토리얼 퍼블리싱
  • 문서 사이트 및 지식 베이스
  • 플러그인 생태계
  • 템플릿 비즈니스

이 섹션은 제품의 형태를 실제 성과와 연결해 주어야 합니다.

Plugins

플러그인 페이지는 단순 릴리스 노트가 아니라 작은 제품 소개 페이지처럼 구성되어야 합니다. 각 페이지에는 다음 내용이 포함되어야 합니다.

  • 플러그인이 하는 일
  • 대상 사용자
  • 현재 상태
  • 가격 또는 제공 방식
  • 다운로드 경로
  • 설치 및 호환성

Templates

템플릿 페이지는 패키지형 사이트 스타터를 쉽게 비교할 수 있어야 합니다. 좋은 항목에는 보통 다음이 포함됩니다.

  • 타깃 사용자
  • 스크린샷
  • 스택 상세 정보
  • 버전 및 릴리스 날짜
  • 데모 링크
  • 다운로드 링크 또는 저장소 링크

Blog and Updates

이 섹션은 지속적인 변화와 진행 상황을 보여줘야 합니다.

  • 릴리스 노트
  • 마이그레이션 가이드
  • 제품 해설
  • 튜토리얼
  • 사례 연구

이것이 사이트를 살아 움직이게 만들고, 시간이 지날수록 가치가 누적되게 합니다.

발행 워크플로

이 프로젝트에서 가장 단순하면서도 안정적인 워크플로는 다음과 같습니다.

  1. docs/에서 콘텐츠 추가 또는 수정
  2. Git diff 검토
  3. 로컬 미리보기
  4. 빌드된 정적 사이트를 Cloudflare Pages에 배포

AI가 초안 작성, 편집, 구조 개선, 일관성 점검을 도와줄 때 이 워크플로는 특히 효과적입니다.

이 구조가 AI와 잘 맞는 이유

사이트가 다음 원칙을 중심으로 구성되면 AI 편집의 신뢰성이 높아집니다.

  • 작은 MDX 파일
  • 명확한 frontmatter
  • 재사용 가능한 페이지 컴포넌트
  • 안정적인 라우트 패턴
  • UI 코드와 분리된 콘텐츠

그래서 현재 사이트 구조는 의도적으로 콘텐츠 우선으로 설계되었습니다.

이것이 EmDash 본체와 연결되는 방식

공식 EmDash 자료는 런타임 컬렉션, 관리자 편집, 플러그인, 미디어 저장소, 클라우드 이식성을 강조합니다. 이는 분명한 제품 강점입니다. 다만 대외 공개형 생태계 사이트는 처음부터 이 모든 것을 동시에 필요로 하진 않습니다.

정적 사이트는 공개 프레젠테이션 레이어입니다.

다음 요구가 생기면 전체 EmDash 런타임을 다음 레이어로 도입하면 됩니다.

  • 비기술 편집자의 브라우저 작업
  • 인증 기반 기여 플로
  • 런타임 기반 미디어 관리
  • 더 풍부한 자동화 또는 플러그인 제출 워크플로

편집 실무 원칙

모든 페이지는 다음 질문 중 최소 하나에 명확히 답해야 합니다.

  • EmDash는 무엇인가?
  • 왜 WordPress가 아닌가?
  • 이 플러그인 또는 템플릿은 무엇을 하는가?
  • 어떻게 마이그레이션하는가?
  • 어떻게 배포하는가?
  • 왜 지금 도입할 가치가 있는가?

페이지가 이 질문 중 하나에도 충분히 답하지 못한다면, 범위를 더 좁혀야 할 가능성이 큽니다.