Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
23 changes: 11 additions & 12 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,28 +32,27 @@
- **段階的な学習**:基礎から応用まで体系的に学習可能
- **実践演習**:各章に豊富な演習問題と解答例
- **豊富な図表**:理解を深める視覚的補助資料
- **シンプルな3部構成**:基本原則→設計・開発→チーム・現代実践の自然な流れ

## 目次

### 導入編
- **第0章 はじめに** ✅ - なぜあなたのコードは6ヶ月後に読めなくなるのか?

### 第I部:基礎原則編
### 第I部:プログラミングの基本原則
- **第1章 美しいソースコードの基本原則** ✅ - 七箇条と品質属性
- **第2章 命名の重要性とベストプラクティス** ✅ - Name and Conquer戦略
- **第3章 モデリングとしてのプログラミング** ✅ - 関心の分離と抽象化

### 第II部:設計原則編
### 第II部:設計と開発の実践
- **第4章 マルチパラダイムプログラミング** ✅ - 命令型vs宣言型
- **第5章 オブジェクト指向設計の真髄** ✅ - SOLID原則とカプセル化
- **第6章 テスト駆動開発とTestable設計** ✅ - TDD実践とF.I.R.S.T原則

### 第III部:実践技法編
- **第7章 リファクタリングと継続的品質改善** ✅ - コードの臭いと改善戦略
- **第8章 実践的なコーディング手法** ✅ - Think Simple と意図表現
- **第9章 チーム開発における品質管理** ✅ - コードレビューとCI/CD

### 第IV部:現代的技術編
### 第III部:チームと現代的実践
- **第9章 チーム開発における品質管理** ✅ - コードレビューとCI/CD
- **第10章 現代的なプログラミング技術と将来展望** ✅ - C#進化とクラウド

### 終章
Expand All @@ -69,24 +68,24 @@

## 完成した章の詳細内容

### 基礎原則編
### プログラミングの基本原則
1. **第0章**: AI時代におけるプログラミングの価値、Vibe Codingと本書の関係
2. **第1章**: 美しいソースコードのための七箇条、品質属性、実践演習
3. **第2章**: 命名はモデリングの核心、サービス指向名前付け、アンチパターン対策
4. **第3章**: プログラミング=設計+実装+テスト、関心の分離、ドメインモデル

### 設計原則編
### 設計と開発の実践
5. **第4章**: 命令型vs宣言型、オブジェクト指向、関数型、パラダイム選択
6. **第5章**: 単一責務原則、カプセル化、継承vs委譲、ポリモーフィズム
7. **第6章**: Testable設計、TDD実践、テスト品質、F.I.R.S.T原則

### 実践技法編
8. **第7章**: 段階的改善、コードの臭い、レガシーコード対策、リファクタリング原則
9. **第8章**: Think Simple、意図表現、エラーハンドリング、パフォーマンス最適化
10. **第9章**: コードレビュー、CI/CD、技術的負債管理、チーム品質向上策

### 現代的技術編・終章
### チームと現代的実践
10. **第9章**: コードレビュー、CI/CD、技術的負債管理、チーム品質向上策
11. **第10章**: C#進化、DSL活用、並列処理、クラウドアーキテクチャ、将来展望

### 終章
12. **第11章**: 学習の道のり、継続的成長、プログラミング哲学、次世代への提言

## 核心となる概念
Expand Down
16 changes: 6 additions & 10 deletions website/MarkDown/table-of-contents.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@

---

## 第I部:基礎原則編
## 第I部:プログラミングの基本原則

### [第1章 美しいソースコードの基本原則](chapter-01.md)
1.1 美しいソースコードとは何か
Expand Down Expand Up @@ -46,7 +46,7 @@

---

## 第II部:設計原則編
## 第II部:設計と開発の実践

### [第4章 マルチパラダイムプログラミング](chapter-04.md)
4.1 パラダイムの進化と選択
Expand All @@ -70,10 +70,6 @@
6.4 テストコードの品質向上
6.5 実践演習:TDDによる開発

---

## 第III部:実践技法編

### [第7章 リファクタリングと継続的品質改善](chapter-07.md)
7.1 リファクタリングの基本原則
7.2 コードの臭いと対処法
Expand All @@ -89,6 +85,10 @@
8.5 判断基準とチェックポイント
8.6 実践演習:コーディング技法の応用

---

## 第III部:チームと現代的実践

### [第9章 チーム開発における品質管理](chapter-09.md)
9.1 コードレビューの効果的実践
9.2 コーディング規約の策定と運用
Expand All @@ -97,10 +97,6 @@
9.5 良い開発ツールを使おう
9.6 実践演習:チーム品質向上策

---

## 第IV部:現代的技術編

### [第10章 現代的なプログラミング技術と将来展望](chapter-10.md)
10.1 C#の進化とマルチパラダイム化
10.2 DSL(ドメイン特化言語)の活用
Expand Down
84 changes: 84 additions & 0 deletions 構成シンプル化実施結果.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
# 構成シンプル化実施結果

## 実施内容

### 1. 適切なアドバイスの提供 ✅
- 認知負荷軽減の原則説明
- 論理的流れ強化の重要性
- 参照簡単化の方針

### 2. 具体的な案の提示 ✅
- 4部構成から3部構成への再編成提案
- 付録の整理統合案
- 目次の階層化シンプル化案

### 3. 構成の実際のシンプル化 ✅
以下のファイルを更新して新しい3部構成を実装:

#### 更新ファイル
- `website/MarkDown/table-of-contents.md` - メインの目次構成変更
- `README.md` - プロジェクト概要の構成説明更新
- `計画と進捗/計画と進捗.md` - 計画文書の構成情報更新
- `構成シンプル化提案.md` - 詳細な提案書作成

## 変更前後の比較

### 変更前(4部構成)
```
第I部:基礎原則編(第1-3章)
第II部:設計原則編(第4-6章)
第III部:実践技法編(第7-9章)
第IV部:現代的技術編(第10章)
```

### 変更後(3部構成)
```
第I部:プログラミングの基本原則(第1-3章)
第II部:設計と開発の実践(第4-8章)
第III部:チームと現代的実践(第9-10章)
```

## 達成された改善

### 認知的シンプル化
- ✅ 「3の法則」による理解しやすさ向上
- ✅ 部の数が4→3に削減され、記憶しやすくなった

### バランスの向上
- ✅ 各部の章数がより均等に分散
- ✅ 第II部に設計から実践技法まで統合され、学習の流れが自然になった

### 論理的流れの強化
- ✅ 個人の基本原則 → 設計・開発実践 → チーム・現代技術の自然な進行
- ✅ 理論から実践への段階的な構成

### ナビゲーション改善
- ✅ より直感的な部構成
- ✅ 関連する内容の統合による参照の簡素化

## 内容の整合性確保

### 変更なし事項
- ✅ 全章の内容は一切変更せず
- ✅ 付録構成は現状維持
- ✅ 章番号・節番号は全て保持

### 一貫性の確保
- ✅ 全ての参照文書で新構成に統一
- ✅ 表現の統一性維持

## 期待される効果

1. **読者体験の向上**
- より理解しやすい学習パス
- 迷いのないナビゲーション

2. **教育効果の向上**
- 自然な学習の流れ
- 段階的スキル向上の実現

3. **参照性の向上**
- 目的の情報への迅速なアクセス
- 関連情報の統合的理解

この構成シンプル化により、包括的な内容を維持しながら、より使いやすく理解しやすい構造を実現しました。
110 changes: 110 additions & 0 deletions 構成シンプル化提案.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,110 @@
# 全体構成シンプル化提案

## 1. 全体の構成をもう少しシンプルにするための、適切なアドバイス

### 現状の課題分析
現在の構成は包括的で教育的価値が高い一方で、以下の課題があります:

#### A. 構成の複雑さ
- **4部構成**:読者にとって部の境界が不明確
- **章数の多さ**:12章は読者にとって長大に感じる可能性
- **付録の充実さ**:6つの付録は包括的だが、参照時に迷いが生じる可能性

#### B. 情報の分散
- 関連する内容が異なる部に分かれている
- 実践的な内容が複数の章に散在

### シンプル化の基本原則

#### 1. **認知負荷の軽減**
- 部の数を3つに削減(人間の記憶に優しい「3の法則」)
- 関連する章をグループ化して理解しやすくする

#### 2. **論理的流れの強化**
- 学習の自然な流れ:基礎 → 設計・開発 → チーム・現代実践
- 理論から実践への明確な段階的進行

#### 3. **参照の簡単化**
- 関連する付録の統合
- より直感的なナビゲーション構造

## 2. 全体の構成をもう少しシンプルにするための、具体的な案

### 提案A:3部構成への再編成(推奨案)

#### 現在の4部構成
```
第I部:基礎原則編(第1-3章)
第II部:設計原則編(第4-6章)
第III部:実践技法編(第7-9章)
第IV部:現代的技術編(第10章)
```

#### 提案する3部構成
```
第I部:プログラミングの基本原則(第1-3章)
第II部:設計と開発の実践(第4-8章)
第III部:チームと現代的実践(第9-10章)
```

#### メリット
- **認知的シンプルさ**:3部構成は理解しやすい
- **バランスの良い分量**:各部がほぼ同等のボリューム
- **論理的流れ**:個人 → 設計・開発 → チーム・現代

### 提案B:付録の整理統合

#### 現在の6付録
```
付録A:美しいソースコードのための七箇条
付録B:命名規則とコーディング規約例
付録C:リファクタリングパターン集
付録D:新人プログラマーのためのコーディングの心得Q&A
付録E:参考文献と出典
付録F:用語集
```

#### 提案する統合案
```
付録A:美しいソースコードのための七箇条(詳細版)
付録B:実践ガイド(命名規則・コーディング規約・リファクタリングパターン)
付録C:学習サポート(新人向けQ&A・用語集)
付録D:参考文献と出典
```

### 提案C:目次の階層化シンプル化

#### 現在の詳細な小見出し構造を簡略化
- 主要ポイントのみを目次に表示
- 詳細な小見出しは各章内で管理

## 3. 具体的な実装計画

### Phase 1:構造の再編成
1. **table-of-contents.md の更新**
- 3部構成への変更
- 各部のタイトルと説明の最適化

### Phase 2:ナビゲーションの改善
2. **README.md の更新**
- 新しい構造に合わせた説明
- より分かりやすい特徴説明

### Phase 3:一貫性の確保
3. **各章ファイルの調整**
- 必要に応じて章間の参照リンクを更新
- 統一感のある表現への調整

## 期待される効果

### 読者にとっての改善
- **理解しやすさの向上**:3部構成による明確な学習パス
- **ナビゲーションの改善**:目的の情報への素早いアクセス
- **学習効率の向上**:段階的で自然な学習フロー

### 教育効果の向上
- **記憶しやすい構造**:3の法則による認知負荷軽減
- **実践的な学習**:理論と実践の明確な区分
- **継続的な参照**:分かりやすい付録構成

この提案により、包括的な内容を維持しながら、より使いやすく理解しやすい構成を実現できます。
9 changes: 4 additions & 5 deletions 計画と進捗/計画と進捗.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,10 @@
- 300ページ以上の詳細な内容

### 章構成(全10章+付録)
1. **第I部:基礎原則編**(第1-3章)
2. **第II部:設計原則編**(第4-6章)
3. **第III部:実践技法編**(第7-9章)
4. **第IV部:現代的技術編**(第10章)
5. **付録**(A-E)
1. **第I部:プログラミングの基本原則**(第1-3章)
2. **第II部:設計と開発の実践**(第4-8章)
3. **第III部:チームと現代的実践**(第9-10章)
4. **付録**(A-F)

## 執筆進捗

Expand Down