利用ガイド
このサイトを EmDash のドキュメント、移行コンテンツ、プラグイン、テンプレート、製品アップデートの公開システムとして使います。
このウェブサイトに期待すること
emdashcmseverything.com は汎用ランディングページのように振る舞うべきではありません。EmDash エコシステム向けの公開ナレッジと配布の層として機能すべきです。
そのため、一つの一貫したシステムで複数のコンテンツ役割を担います。
- EmDash が何かを説明する
- 仕組みを教える
- どこにフィットするかを示す
- プラグインとテンプレートを公開する
- WordPress 移行を案内する
- 製品の進捗とリリースを告知する
推奨される情報設計
現在の構造はそのモデルを支えるよう設計されています。
- 長く価値の残るドキュメントは
docs/docs - シナリオ起点の採用コンテンツは
docs/use-cases - プラグインディレクトリのエントリは
docs/plugins - テンプレートディレクトリのエントリは
docs/templates - アップデート、チュートリアル、編集コンテンツは
docs/faq
単一のマーケティングトップにすべてを詰め込むより、フレームワークのコンポーネントの内側に製品情報を隠すより、こちらの方が適しています。
各セクションの使い方
Docs
耐久性が高く、意図が明確なコンテンツ向けです。
- はじめに
- 機能の説明
- デプロイのメモ
- アーキテクチャの概要
- FAQ
評価の前後に人々が尋ねる質問に答えるページにします。
Use Cases
製品の能力を購入者の文脈に翻訳するセクションです。次のように位置づけると EmDash は理解しやすくなります。
- 編集出版
- ドキュメントとナレッジベース
- プラグインエコシステム
- テンプレート事業
製品の形と実際の成果を結びつけます。
Plugins
プラグインページはリリースノートだけでなく、小さなプロダクトページのように感じられるべきです。それぞれが次を説明します。
- プラグインが何をするか
- 誰向けか
- 現在のステータス
- 価格または入手方法
- ダウンロード経路
- セットアップと互換性
Templates
パッケージされたサイトスターターを比較しやすくします。良いエントリには次が含まれます。
- 対象読者
- スクリーンショット
- スタックの詳細
- バージョンとリリース日
- デモリンク
- ダウンロードまたはリポジトリへのリンク
ブログとアップデート
動きを記録するセクションです。
- リリースノート
- 移行ガイド
- 製品コメンタリー
- チュートリアル
- 事例
サイトが活発で積み上がっている感じが保たれます。
公開ワークフロー
このプロジェクトでは、最もシンプルで健全な流れは次のとおりです。
docs/でコンテンツを追加または改訂する- Git の差分をレビューする
- ローカルでプレビューする
- ビルドした静的サイトを Cloudflare Pages にデプロイする
AI が下書き、編集、再構成、一貫性の面で手伝うときに特に効きます。
この構造が AI と相性がよい理由
次の前提でサイトが組まれていると、AI による編集はずっと信頼しやすくなります。
- 小さな MDX ファイル
- 明示的なフロントマター
- 再利用可能なページコンポーネント
- 安定したルートパターン
- UI コードから分離されたコンテンツ
現在のサイト形状が意図的にコンテンツファーストなのはこのためです。
EmDash 本体との関係
公式の EmDash の資料は、ランタイムコレクション、管理編集、プラグイン、メディアストレージ、クラウド移植性を強調します。それらは製品の強みです。ただし公開向けエコシステムサイトがそれらすべてをすぐに必要とするわけではありません。
静的サイトは公開プレゼンテーション層です。
フル EmDash ランタイムは、次が必要になったときの次の層です。
- 非技術者の編集者がブラウザで作業する
- 認証されたコントリビューターフロー
- ランタイム管理のメディア
- より豊富な自動化やプラグイン提出ワークフロー
編集の目安
各ページは、次のいずれかに明確に答えるべきです。
- EmDash とは何か？
- WordPress でなくてよい理由は？
- このプラグインやテンプレートは何をするか？
- どう移行するか？
- どうデプロイするか？
- 今採用する価値は何か？
どれにもよく答えられないなら、スコープを絞る必要があるでしょう。