一つのPROJECTを作り終えると、時系列の記事が残ります。しかし、その中で見つけた設定方法や不具合の原因は、PROJECTを最初から読まない人にも役立つ知識です。
MANIARUでは、PROJECT 002で社内向けWordPressを作った記録から、ユーザー権限、検索、業務フロー、バックアップ、コード上の問題などをCATEGORY記事へ分けました。実験の流れを残す記事と、特定の疑問から読める記事を両方作るためです。
この記事では、一つの実験を複数の記事へ機械的に分割するのではなく、再利用できる知識を見つけてCATEGORY記事へ変える方法を整理します。
PROJECT記事とCATEGORY記事は役割が違う
PROJECT記事は、目的を決めてから完成まで進んだ順番を残します。何を作り、どこで判断し、次に何をしたかをたどれる記録です。
CATEGORY記事は、一つのテーマだけを入口にします。「WordPressでバックスラッシュが消える」「複数人の権限をどう分ける」といった疑問から読んでも、必要な内容が分かる形にします。
| 記事 | 中心にするもの | 読み方 |
|---|---|---|
| PROJECT | 実験全体の流れと判断 | STEPを順番にたどる |
| CATEGORY | 一つの問題・方法・学び | 知りたいテーマから読む |
同じ出来事を扱っても、記事の入口が違います。PROJECT本文を短く言い換えるだけでは、CATEGORY記事を作った意味がありません。
最初に、実験で起きたことを一覧にする
PROJECT 002の公開後、各STEPと制作中の記録から、独立して説明できそうな出来事を拾いました。
- 設計で決めたこと
- 実装に使った方法
- 運用前に確認したこと
- 実際に使って見つかった問題
- 原因を調べて直したこと
- 次の制作でも使える判断基準
この段階ではタイトルを量産しません。まず「何が起きたか」「なぜ困ったか」「どう確認したか」を短く並べました。出来事が具体的であれば、記事の中心も決めやすくなります。
一記事で一つの疑問に答えられるか確認する
候補を出したあと、その内容だけを知りたい読者がいるかを確認しました。
| PROJECT内の出来事 | CATEGORY記事の入口 |
|---|---|
| コメント編集で共有パスが変わった | wp_slash()と保存時のエスケープ |
| 複数人をまとめて登録した | WordPressのユーザー・権限・チームの分け方 |
| 投稿を確認して完了へ進めた | 状態をつないだ業務フロー |
| 完了後にデータを残した | バックアップと復元条件 |
| PDFを複数扱った | 表示名とダウンロード導線 |
読者の疑問を一文で表せない候補は、範囲が広すぎる可能性があります。反対に、数行で終わる内容は別記事の一部として扱います。
既存記事との重複を先に確認する
候補が決まったら、タイトル、slug、記事一覧、既存本文を確認しました。同じ言葉を使っていなくても、結論が同じなら新しい記事にはしません。
- 既存記事と目的が同じではないか
- 同じ実体験を同じ順番で説明していないか
- 新しい記事だけの具体例や判断があるか
- 既存記事へ追記する方が自然ではないか
PROJECTとCATEGORYの両方に同じ事実が出る場合も、PROJECTでは時系列上の意味、CATEGORYでは仕組みや再現条件を中心にします。互いの記事は、続きではなく別の入口として内部リンクでつなぎました。
カテゴリーは内容から決める
PROJECT 002から生まれた記事を、すべてBUILDへ入れたわけではありません。記事が答える内容に合わせて分類しました。
- AI:指示、確認、再開、公開判断の分担
- WEB:WordPressの画面構成や導線
- CODE:保存処理、コメント、ログアウトなどの実装
- BUILD:バックアップ、権限、業務フローの設計
- GROW:使った後の改善と知識の蓄積
元になったPROJECTではなく、CATEGORY記事そのものの主題で決めます。これにより、PROJECTを知らない読者も普段使うカテゴリーから記事を見つけられます。
記事を作る順番は、足りない入口から決める
候補が多いときは、思いついた順に公開しませんでした。公開済み記事の数と内容を確認し、入口が少ないカテゴリー、既存記事から自然につながるテーマ、具体的な実体験がそろっているテーマを優先しました。
- 公開中のCATEGORY記事数を確認する
- PROJECTと作業記録から候補を出す
- 既存記事との重複を確認する
- 優先カテゴリーと公開順を決める
- 一記事ずつ作り、公開後に表示を確認する
今回は17本だったCATEGORY記事へ13本を追加し、合計30本にしました。まとめて下書きを作って一括公開するのではなく、各記事で本文、アイキャッチ、設定、公開ページを確認してから次へ進めています。
1つの実験を、検索できる知識へ変える
PROJECTには、完成した機能だけでなく、判断、失敗、修正、確認が残ります。そのままでは長い流れの中に埋もれる内容も、一つの疑問へ絞ると別の制作で使える知識になります。
PROJECTで実験の流れを残し、CATEGORYで問題ごとの知識を取り出し、互いをリンクでつなぐ。
この形にしたことで、一つの制作記録を繰り返すのではなく、時系列で読みたい人と、答えから探したい人の両方に入口を作れました。PROJECTとCATEGORYをつなぐ基本設計は、PROJECTとCATEGORYをつなぐ知識システムでまとめています。