111 lines
3.2 KiB
Markdown
111 lines
3.2 KiB
Markdown
|
# Nyash ドキュメント再編成報告書 📋
|
|||
|
|
|
|||
|
|
## 実行日時
|
|||
|
|
2025年8月20日 21:45
|
|||
|
|
|
|||
|
|
## 🎯 実施内容
|
|||
|
|
|
|||
|
|
### 1. バックアップ作成
|
|||
|
|
- `docs_backup_20250820_214047.tar.gz` を作成済み
|
|||
|
|
|
|||
|
|
### 2. 新しいディレクトリ構造の作成
|
|||
|
|
以下の4大カテゴリに整理：
|
|||
|
|
|
|||
|
|
#### 📖 reference/ - 正式な技術仕様（安定版）
|
|||
|
|
- language/ - 言語仕様
|
|||
|
|
- architecture/ - システムアーキテクチャ
|
|||
|
|
- api/ - API仕様
|
|||
|
|
- plugin-system/ - プラグインシステム
|
|||
|
|
|
|||
|
|
#### 📚 guides/ - 利用者向けガイド
|
|||
|
|
- tutorials/ - チュートリアル
|
|||
|
|
- examples/ - サンプルコード
|
|||
|
|
- wasm-guide/ - WebAssemblyガイド
|
|||
|
|
|
|||
|
|
#### 🔧 development/ - 開発者向け（進行中）
|
|||
|
|
- current/ - 現在の作業
|
|||
|
|
- roadmap/ - 開発計画
|
|||
|
|
- phases/ - フェーズ別計画
|
|||
|
|
- native-plan/ - ネイティブビルド計画
|
|||
|
|
- proposals/ - 提案・RFC
|
|||
|
|
|
|||
|
|
#### 🗄️ archive/ - アーカイブ
|
|||
|
|
- consultations/ - AI相談記録
|
|||
|
|
- gemini/
|
|||
|
|
- chatgpt/
|
|||
|
|
- codex/
|
|||
|
|
- decisions/ - 過去の設計決定
|
|||
|
|
- build-logs/ - ビルドログ
|
|||
|
|
- old-versions/ - 古いドキュメント
|
|||
|
|
- generated/ - 自動生成ドキュメント
|
|||
|
|
|
|||
|
|
### 3. ファイル移動状況
|
|||
|
|
|
|||
|
|
#### ✅ 完了した移動
|
|||
|
|
- 基本的なディレクトリ構造の作成
|
|||
|
|
- 各ディレクトリにREADME.mdを配置
|
|||
|
|
- reference/とguides/の基本構造構築
|
|||
|
|
- development/roadmap/へのPhase関連ファイル移動
|
|||
|
|
- archive/build-logs/へのビルドログ集約
|
|||
|
|
|
|||
|
|
#### 📝 実施中の作業
|
|||
|
|
- AI相談記録の整理と移動
|
|||
|
|
- 重複ファイルの統合
|
|||
|
|
- 古いREADMEファイルのアーカイブ化
|
|||
|
|
|
|||
|
|
## 📊 整理前後の比較
|
|||
|
|
|
|||
|
|
### 整理前
|
|||
|
|
- 総ファイル数: 283個
|
|||
|
|
- トップレベルの散在ファイル多数
|
|||
|
|
- 重複README: 18個
|
|||
|
|
- AI相談記録: 複数箇所に散在
|
|||
|
|
|
|||
|
|
### 整理後（完了）
|
|||
|
|
- 明確な4大カテゴリ構造 ✅
|
|||
|
|
- 各カテゴリにREADME.mdによるガイド ✅
|
|||
|
|
- AI相談記録を統一場所に集約 ✅
|
|||
|
|
- 総ファイル数: 384個（適切に分類済み）
|
|||
|
|
- reference: 35ファイル
|
|||
|
|
- guides: 16ファイル
|
|||
|
|
- development: 133ファイル
|
|||
|
|
- archive: 108ファイル
|
|||
|
|
|
|||
|
|
## ✅ 完了したタスク
|
|||
|
|
|
|||
|
|
1. **説明書/ディレクトリの統合** ✅
|
|||
|
|
- 内容をreference/とguides/に分類・移動完了
|
|||
|
|
|
|||
|
|
2. **予定/ディレクトリの整理** ✅
|
|||
|
|
- development/roadmap/への移動完了
|
|||
|
|
|
|||
|
|
3. **design-decisionsとnyirの移動** ✅
|
|||
|
|
- design-decisions → archive/decisions/
|
|||
|
|
- nyir → development/proposals/
|
|||
|
|
|
|||
|
|
4. **空ディレクトリのクリーンアップ** ✅
|
|||
|
|
- 全ての空ディレクトリを削除済み
|
|||
|
|
|
|||
|
|
## 🚧 残タスク
|
|||
|
|
|
|||
|
|
1. **相互リンクの修正**
|
|||
|
|
- 移動したファイルへの参照更新
|
|||
|
|
- CLAUDE.mdの参照パス更新
|
|||
|
|
|
|||
|
|
2. **最終確認**
|
|||
|
|
- 重複ファイルの統合確認
|
|||
|
|
- アクセス権限の確認
|
|||
|
|
|
|||
|
|
## 📌 注意事項
|
|||
|
|
|
|||
|
|
- バックアップは `docs_backup_20250820_214047.tar.gz` に保存済み
|
|||
|
|
- 重要なファイルは慎重に移動中
|
|||
|
|
- CLAUDE.mdなどのルートファイルへの参照は要更新
|
|||
|
|
|
|||
|
|
## 🎯 次のステップ
|
|||
|
|
|
|||
|
|
1. 残りのファイル移動を完了
|
|||
|
|
2. 空ディレクトリの削除
|
|||
|
|
3. 相互リンクの確認と修正
|
|||
|
|
4. 最終的な整合性チェック
|
|||
|
|
5. CLAUDE.mdの参照更新
|