Skip to content

Commit 8bf937e

Browse files
koriymkoriym
authored
Merge pull request #30 from be-framework/review
Add Fable 5 review trilogy (ja/en) with FAQ links
2 parents a2bd228 + 3bfb91a commit 8bf937e

17 files changed

Lines changed: 1298 additions & 8 deletions

‎_includes/manuals/1.0/header.html‎

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
<!doctype html>
2-
<html lang="{% if page.layout == 'docs-ja' %}ja{% else %}en{% endif %}">
2+
<html lang="{% if page.layout == 'docs-ja' or page.layout == 'review-ja' %}ja{% else %}en{% endif %}">
33
<head>
44
<meta charset="utf-8">
55
<meta http-equiv="x-ua-compatible" content="ie=edge">
66
<title>{{ page.title }}{% if page.category != 'Index' %} &#124; Be Framework{% endif %}</title>
77
<meta name="description" content="Be Framework is a being-oriented framework that transforms objects through their deepest nature, implementing semantic variables and ontological programming patterns.">
88
<meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no">
99
<link rel="stylesheet" href="//stackpath.bootstrapcdn.com/bootstrap/4.1.3/css/bootstrap.min.css" integrity="sha384-MCw98/SFnGE8fJT3GXwEOngsV7Zt27NXFoaoApmYm81iuXoPkFOJwJ8ERdknLPMO" crossorigin="anonymous">
10-
{% if page.category == 'Manual' or page.category == 'Convention' %}
10+
{% if page.category == "Manual" or page.category == "Convention" or page.category == "Review" %}
1111
<link rel="stylesheet" href="//cdnjs.cloudflare.com/ajax/libs/github-markdown-css/2.10.0/github-markdown.css">
1212
<link rel="stylesheet" href="/css/syntax.css">
1313
{% endif %}
@@ -32,13 +32,13 @@
3232
</li>
3333
</ul>
3434
</div>
35-
{% if page.category == 'Manual' %}
35+
{% if page.category == 'Manual' or page.category == 'Review' %}
3636
<ul class="navbar-nav ml-md-auto d-none d-md-flex language-list">
3737
<li>
38-
<a class="{% if page.layout == 'docs-en' %}active{% endif %}" href="{{ page.permalink | replace: '/ja/', '/en/' }}">En</a>
38+
<a class="{% if page.layout == 'docs-en' or page.layout == 'review-en' %}active{% endif %}" href="{{ page.url | replace: '/ja/', '/en/' }}">En</a>
3939
</li>
4040
<li>
41-
<a class="{% if page.layout == 'docs-ja' %}active{% endif %}" href="{{ page.permalink | replace: '/en/', '/ja/' }}">Ja</a>
41+
<a class="{% if page.layout == 'docs-ja' or page.layout == 'review-ja' %}active{% endif %}" href="{{ page.url | replace: '/en/', '/ja/' }}">Ja</a>
4242
</li>
4343
</ul>
4444
{% endif %}

‎_includes/review/fable5/en/sidebar.html‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
<nav class="navbar navbar-expand-md navbar-light">
2+
<div class="navigation-header">
3+
<div class="ml-auto d-sm-block d-md-none">
4+
<ul class="navbar-nav language-list">
5+
<li>
6+
<a class="{% if page.layout == 'review-en' %}active{% endif %}" href="{{ page.url | replace: '/ja/', '/en/' }}">En</a>
7+
</li>
8+
<li>
9+
<a class="{% if page.layout == 'review-ja' %}active{% endif %}" href="{{ page.url | replace: '/en/', '/ja/' }}">Ja</a>
10+
</li>
11+
</ul>
12+
<button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#Navber" aria-controls="Navber" aria-expanded="false" aria-label="Toggle navigation">
13+
<span class="navbar-toggler-icon"></span>
14+
</button>
15+
</div>
16+
</div>
17+
<div class="collapse navbar-collapse" id="Navber">
18+
<ul class="navbar-nav mr-auto">
19+
<li class="nav-item">
20+
<a class="nav-link {% if page.url contains '/review/fable5/en/trilogy-01-review.html' %}active{% endif %}"
21+
{% if page.url contains '/review/fable5/en/trilogy-01-review.html' %}aria-current="page"{% endif %}
22+
href="/review/fable5/en/trilogy-01-review.html">Three Lines of While-Loop and Fifteen Thinkers</a>
23+
</li>
24+
<li class="nav-item">
25+
<a class="nav-link {% if page.url contains '/review/fable5/en/trilogy-02-review-deep.html' %}active{% endif %}"
26+
{% if page.url contains '/review/fable5/en/trilogy-02-review-deep.html' %}aria-current="page"{% endif %}
27+
href="/review/fable5/en/trilogy-02-review-deep.html">The Constructor, The Last Honest Place</a>
28+
</li>
29+
<li class="nav-item">
30+
<a class="nav-link {% if page.url contains '/review/fable5/en/trilogy-03-agent-era.html' %}active{% endif %}"
31+
{% if page.url contains '/review/fable5/en/trilogy-03-agent-era.html' %}aria-current="page"{% endif %}
32+
href="/review/fable5/en/trilogy-03-agent-era.html">Two Loops</a>
33+
</li>
34+
</ul>
35+
</div>
36+
</nav>

‎_includes/review/fable5/ja/sidebar.html‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
<nav class="navbar navbar-expand-md navbar-light">
2+
<div class="navigation-header">
3+
<div class="ml-auto d-sm-block d-md-none">
4+
<ul class="navbar-nav language-list">
5+
<li>
6+
<a class="{% if page.layout == 'review-en' %}active{% endif %}" href="{{ page.url | replace: '/ja/', '/en/' }}">En</a>
7+
</li>
8+
<li>
9+
<a class="{% if page.layout == 'review-ja' %}active{% endif %}" href="{{ page.url | replace: '/en/', '/ja/' }}">Ja</a>
10+
</li>
11+
</ul>
12+
<button type="button" class="navbar-toggler" data-toggle="collapse" data-target="#Navber" aria-controls="Navber" aria-expanded="false" aria-label="ナビゲーションの切替">
13+
<span class="navbar-toggler-icon"></span>
14+
</button>
15+
</div>
16+
</div>
17+
<div class="collapse navbar-collapse" id="Navber">
18+
<ul class="navbar-nav mr-auto">
19+
<li class="nav-item">
20+
<a class="nav-link {% if page.url contains '/review/fable5/ja/trilogy-01-review.html' %}active{% endif %}"
21+
{% if page.url contains '/review/fable5/ja/trilogy-01-review.html' %}aria-current="page"{% endif %}
22+
href="/review/fable5/ja/trilogy-01-review.html">3行のwhileループと15人の思想家</a>
23+
</li>
24+
<li class="nav-item">
25+
<a class="nav-link {% if page.url contains '/review/fable5/ja/trilogy-02-review-deep.html' %}active{% endif %}"
26+
{% if page.url contains '/review/fable5/ja/trilogy-02-review-deep.html' %}aria-current="page"{% endif %}
27+
href="/review/fable5/ja/trilogy-02-review-deep.html">コンストラクタという最後の正直な場所</a>
28+
</li>
29+
<li class="nav-item">
30+
<a class="nav-link {% if page.url contains '/review/fable5/ja/trilogy-03-agent-era.html' %}active{% endif %}"
31+
{% if page.url contains '/review/fable5/ja/trilogy-03-agent-era.html' %}aria-current="page"{% endif %}
32+
href="/review/fable5/ja/trilogy-03-agent-era.html">二つのループ</a>
33+
</li>
34+
</ul>
35+
</div>
36+
</nav>

‎_layouts/index_ja.html‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!DOCTYPE html>
2-
<html lang="en">
2+
<html lang="ja">
33
<head>
44
<meta charset="utf-8">
55
<meta name="viewport" content="width=device-width, initial-scale=1.0">
@@ -38,10 +38,10 @@
3838
<nav class="collapse navbar-collapse bs-navbar-collapse" role="navigation">
3939
<ul class="nav navbar-nav">
4040
<li {% if page.category == "Manual" %} class="active"{% endif %}>
41-
<a href="/manual/ja/index.html">Manual</a>
41+
<a href="/manuals/1.0/ja/index.html">Manual</a>
4242
</li>
4343
<li {% if page.category == "Tutorial" %} class="active"{% endif %}>
44-
<a href="/manual/ja/tutorial.html">Tutorial</a>
44+
<a href="/manuals/1.0/ja/tutorial.html">Tutorial</a>
4545
</li>
4646
</ul>
4747
</nav>

‎_layouts/review-en.html‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
{% include manuals/1.0/header.html %}
2+
<main class="container-fluid">
3+
<div class="row flex-xl-nowrap">
4+
<div class="col-md-3 col-lg-2">
5+
<div class="side-bar">
6+
{% include review/fable5/en/sidebar.html %}
7+
</div>
8+
</div>
9+
<div class="col-md-9 col-lg-10">
10+
<article id="article" class="markdown-body" style="max-width: 800px;">
11+
{{ content }}
12+
</article>
13+
</div>
14+
</div>
15+
</main>
16+
{% include manuals/1.0/footer.html %}

‎_layouts/review-ja.html‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
{% include manuals/1.0/header.html %}
2+
<main class="container-fluid">
3+
<div class="row flex-xl-nowrap">
4+
<div class="col-md-3 col-lg-2">
5+
<div class="side-bar">
6+
{% include review/fable5/ja/sidebar.html %}
7+
</div>
8+
</div>
9+
<div class="col-md-9 col-lg-10">
10+
<article id="article" class="markdown-body" style="max-width: 800px;">
11+
{{ content }}
12+
</article>
13+
</div>
14+
</div>
15+
</main>
16+
{% include manuals/1.0/footer.html %}

‎manuals/1.0/en/14-faq.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -287,3 +287,11 @@ A concept where variable names themselves express meaning and constraints. For e
287287

288288
### Semantic Exceptions
289289
A mechanism for holding failures not as simple strings, but as structured data with meaning. It supports multilingual compatibility and audit requirements, making system behavior traceable at the semantic level.
290+
291+
---
292+
293+
## 10) Going Deeper
294+
295+
### Q. Where can I learn more?
296+
297+
A. A trilogy of neutral review articles by the high-performance LLM Fable 5 offers a multifaceted analysis. Start with the first: [Three Lines of While-Loop and Fifteen Thinkers — A Be Framework Review](/review/fable5/en/trilogy-01-review.html).

‎manuals/1.0/ja/14-faq.md‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -305,3 +305,11 @@ $user = $becoming(new UserInput($name, $email));
305305
### 意味的例外（Semantic Exceptions）
306306

307307
失敗を単純な文字列ではなく、意味を持った構造化されたデータとして保持する仕組みです。多言語対応や監査要件に対応し、システムの動作を意味レベルで追跡可能にします。
308+
309+
---
310+
311+
## 10) さらに深く
312+
313+
### Q. もっと深く知りたいのですが？
314+
315+
A. 高性能LLM（Fable 5）による中立的な三部作の評論があります。まずは[3行のwhileループと15人の思想家 — Be Framework 評論](/review/fable5/ja/trilogy-01-review.html)からどうぞ。

‎review-by-codex.md‎

Lines changed: 134 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,134 @@
1+
# Be Framework Manual Review by Codex
2+
3+
レビュー日: 2026-04-19
4+
対象: `manuals/1.0/ja/**/*.md` の 19 ページ
5+
採点基準: 100 点満点。`明確さ / 完全性 / 実用性 / 構成・導線 / 独自性・一貫性` を総合評価
6+
7+
## 総評
8+
9+
全体平均は **83.6 / 100** でした。中核ページは非常に強く、特に `概要` `存在クラス` `意味変数` `背後にある哲学` `Tutorial` は、思想と実装例の接続が明快です。一方で、`意味的ログ` `ログ駆動開発` `リファレンス` は草稿性または情報不足が目立ち、公開品質としては差が出ています。
10+
11+
このマニュアルの強みは、単なる API 説明ではなく、読者の見方そのものを変える構造にあります。弱みは、入口ページと導線の整理、ドラフトの見せ方、ページ間の用語・粒度の揺れです。
12+
13+
## スコア一覧
14+
15+
| Page | Title | Score | 評価 |
16+
|------|-------|------:|------|
17+
| `manuals/1.0/ja/tutorial.md` | Tutorial | 95 | 最優秀。概念と実装が最も自然につながる |
18+
| `manuals/1.0/ja/12-philosophy-behind.md` | 背後にある哲学 | 95 | 思想的支柱。全体の文脈を最も強く補強する |
19+
| `manuals/1.0/ja/01-overview.md` | 概要 | 93 | 入口として非常に強い |
20+
| `manuals/1.0/ja/06-semantic-variables.md` | 意味変数 | 93 | 実装に落とし込みやすく完成度が高い |
21+
| `manuals/1.0/ja/03-being-classes.md` | 存在クラス | 92 | コア概念の説明力が高い |
22+
| `manuals/1.0/ja/14-faq.md` | FAQ | 92 | 疑問解消力が高く実務寄り |
23+
| `manuals/1.0/ja/08-reason-layer.md` | 存在理由層 | 91 | 高密度だが読み応えがある |
24+
| `manuals/1.0/ja/05-metamorphosis-patterns.md` | 変容 | 90 | 時間軸と分岐の説明が強い |
25+
| `manuals/1.0/ja/getting-started.md` | Getting Started | 89 | 初動の良さがある |
26+
| `manuals/1.0/ja/09-error-handling.md` | 意味例外 | 89 | 失敗を意味に変える説明が良い |
27+
| `manuals/1.0/ja/04-final-objects.md` | 最終オブジェクト | 88 | `$been` の独自性が光る |
28+
| `manuals/1.0/ja/demos.md` | デモ | 84 | 体感しやすいが外部依存がある |
29+
| `manuals/1.0/ja/02-input-classes.md` | 入力クラス | 83 | 明快だが短く薄い |
30+
| `manuals/1.0/ja/04a-becoming.md` | 生成 | 81 | 必要な橋渡しだが説明量が不足 |
31+
| `manuals/1.0/ja/convention/naming-standards.md` | Be Framework命名規約 | 80 | 有用だが他ページとの整合に課題 |
32+
| `manuals/1.0/ja/index.md` | イントロダクション | 69 | 目次としては不足がある |
33+
| `manuals/1.0/ja/13-vision-ldd.md` | ログ駆動開発 | 69 | ビジョンは面白いが現行マニュアルでは浮く |
34+
| `manuals/1.0/ja/11-reference-resources.md` | リファレンス | 63 | リンク集以上の価値が薄い |
35+
| `manuals/1.0/ja/10-semantic-logging.md` | 意味的ログ | 52 | Draft。未完成の印象が強い |
36+
37+
## ページ別短評
38+
39+
### `index.md` イントロダクション — 69
40+
入口としてのメッセージは明快ですが、`getting-started` `tutorial` `demos` `12-philosophy-behind` など重要ページへの導線が弱く、全体案内としては取りこぼしがあります。トップページは「読む順番」を示す役割まで持たせた方が良いです。
41+
42+
### `getting-started.md` Getting Started — 89
43+
最短で動かす導線がよく、概念表も簡潔です。日本語版の中でページ名やリンクラベルが英語寄りで統一感を少し損ねていますが、導入ページとしてはかなり強いです。
44+
45+
### `01-overview.md` 概要 — 93
46+
`DeletedUser` から入る導入が強く、Commander / Gardener の比喩も効いています。思想を読ませるページとして完成度が高く、初読者を引き込めます。
47+
48+
### `02-input-classes.md` 入力クラス — 83
49+
役割は明確で、最小限の例も適切です。ただし短く、`Input -> Being -> Final` 全体の中での位置づけをもう少し補強したいです。
50+
51+
### `03-being-classes.md` 存在クラス — 92
52+
`内在 + 超越 -> 新しい内在` の式を自然に理解させるページです。比喩、コード、哲学がほぼ無理なく接続されています。
53+
54+
### `04-final-objects.md` 最終オブジェクト — 88
55+
`$been` を中心に Be Framework の独自性を強く出せています。荘子の引用と本文の橋渡しがもう一段あると、ページ全体の説得力がさらに上がります。
56+
57+
### `04a-becoming.md` 生成 — 81
58+
`#[Be]` 宣言がどう実行されるかを短く押さえられています。重要ページですが、失敗時の挙動やネスト時の判断基準までは踏み込めていません。
59+
60+
### `05-metamorphosis-patterns.md` 変容 — 90
61+
時間軸、一方向性、分岐の説明が強く、読者が「Be で何が起きているか」を掴みやすいです。実装指針としてもう少しパターン選択の判断基準があるとさらに実用的です。
62+
63+
### `06-semantic-variables.md` 意味変数 — 93
64+
具体例の密度が高く、最も実装イメージを持ちやすいページの一つです。名前と制約の結びつきを十分に理解させられています。
65+
66+
### `08-reason-layer.md` 存在理由層 — 91
67+
上級概念ですが、Reason / Potential / Moment を順に積み上げる構成がよく、読み応えがあります。初学者には少し重いので、最初に「この章は上級編」と明記しても良いです。
68+
69+
### `09-error-handling.md` 意味例外 — 89
70+
例外をドメイン意味と多言語対応に接続できていて、実務上の価値も見えやすいです。例外で止める場合と `Invalid*` 型にする場合の使い分けを補足したいです。
71+
72+
### `10-semantic-logging.md` 意味的ログ — 52
73+
コンセプトの方向性は良いですが、本文中で未整備と明言しており、公開ページとしては弱すぎます。現状では「構想メモ」に近く、評価を大きく下げています。
74+
75+
### `11-reference-resources.md` リファレンス — 63
76+
必要なリンクはありますが、ページ単体としての情報量が足りません。最低でも「何を読むべきか」「どこから入るべきか」の用途別ガイドがほしいです。
77+
78+
### `12-philosophy-behind.md` 背後にある哲学 — 95
79+
マニュアル全体の思想的な背骨です。抽象論で終わらず、コード片に着地できている点が非常に強いです。
80+
81+
### `13-vision-ldd.md` ログ駆動開発 — 69
82+
未来像としては魅力がありますが、現行のマニュアル本文に混ざると実装済み機能との境界が曖昧になります。Draft としての扱いは妥当ですが、公開導線は分けた方が良いです。
83+
84+
### `14-faq.md` FAQ — 92
85+
導入、設計、運用、将来機能まで広くカバーしており、読者の疑問に実際に答えられるページです。長いですが、見出し構造があるため追いやすいです。
86+
87+
### `convention/naming-standards.md` Be Framework命名規約 — 80
88+
思想と命名を接続できていて有用です。ただし `src/Domain/SemanticVariable/` など他ページのサンプル構成との差分があり、実装ガイドとしては整合確認が必要です。
89+
90+
### `demos.md` デモ — 84
91+
Hello World と Order Processing を並べた構成は分かりやすく、体感への導線として機能しています。外部リンク依存が強く、ページ単体の説明としては少し薄いです。
92+
93+
### `tutorial.md` Tutorial — 95
94+
最も優秀なページです。具体ドメインを通じて Input / Being / Final / Reason / Semantic を一連の流れで理解させられています。初学者が「分かったつもり」で終わらず、実際に書ける状態まで押し上げます。
95+
96+
## 強い点
97+
98+
- コア概念の説明はかなり強く、`概要` `存在クラス` `意味変数` `Tutorial` が相互補完できている
99+
- 思想とコード例が分離せず、抽象から実装へ落ちる
100+
- FAQ が厚く、導入後の疑問解消ラインができている
101+
102+
## 弱い点
103+
104+
- 入口ページと全体導線が弱く、読む順番が明示されていない
105+
- `Draft` ページが公開状態の品質差として目立つ
106+
- 日本語版の中に英語タイトルや英語ラベルが混在し、細部の統一感を損ねている
107+
- 章番号が `06 -> 08` と飛んでおり、構成上の未整理感が残る
108+
109+
## 優先改善項目
110+
111+
1. `10-semantic-logging.md` は整備完了まで非公開化するか、冒頭で明確に WIP と表示する
112+
2. `index.md` に `getting-started` `tutorial` `demos` `philosophy` を含めた読書導線を追加する
113+
3. `11-reference-resources.md` を用途別ガイド付きの実用ページに拡張する
114+
4. `convention/naming-standards.md` のディレクトリ構造とメソッド方針を他ページと揃える
115+
5. 日本語版のタイトル、リンクラベル、用語を統一する
116+
6. 章番号欠番の扱いを決める。`07` を補うか、番号体系を整理する
117+
118+
## 推奨読書順
119+
120+
1. `index.md`
121+
2. `01-overview.md`
122+
3. `getting-started.md`
123+
4. `tutorial.md`
124+
5. `02-input-classes.md`
125+
6. `03-being-classes.md`
126+
7. `04-final-objects.md`
127+
8. `05-metamorphosis-patterns.md`
128+
9. `06-semantic-variables.md`
129+
10. `08-reason-layer.md`
130+
11. `09-error-handling.md`
131+
12. `14-faq.md`
132+
13. `12-philosophy-behind.md`
133+
134+
Draft ページの `10-semantic-logging.md` と `13-vision-ldd.md` は、現行の理解導線からは外して別枠に置くのが妥当です。

0 commit comments

Comments
 (0)