update readme

Author: na-trium-144

README.md

@@ -58,7 +58,35 @@ npm run lint
 現在は本番環境(my-code.utcode.net)はCoolifyでデプロイしています。
 Cloudflare Worker のビルドログとステータス表示が見れますが、そちらは使っていません。
 
-## ベースとなるドキュメントの作り方
+## ドキュメント
+
+* ドキュメントはセクション(見出し)ごとにわけ、 public/docs/言語id/ページid/並び替え用連番-セクション名.md に置く。
+* ページはディレクトリの名前によらず 言語id/index.yml に書かれている順で表示される。
+* セクションはセクションIDによらずファイル名順で表示される。
+* 各セクションのfrontmatter (各ページ最初のセクション(-intro.md)を除く)
+    ```yml
+    id: 一意なセクションID。ファイル名・ディレクトリ名と一致していなくても良い。バックエンドがこのセクションIDで識別するので、一度コミットしたら変更不可(ファイル名は何度変えても良い)
+    title: セクションタイトルと同じものをmd記法を使わずに書いた文字列
+    level: セクションの見出しレベル(2〜6が使用可)
+    ```
+* コード例はそれが配置されているセクションの内容と関連するようにする。コード例だけを独立したセクションに載せるのは避ける
+    * 良くない例
+    ````md
+    ## 制御構文
+    ### if
+    if文の説明…
+    ### switch
+    switch文の説明…
+    ### コード例
+    ifとswitch共通の注意事項... → ## 制御構文 に移す
+    ```
+    ifとswitchを使ったコード例… → 2つのコード例に分割する
+    ```
+    ````
+* REPLのコード例は1セクションに最大1つまで。
+* ページ0以外の各ページの最後はレベル2見出し「この章のまとめ」と、レベル3見出し「練習問題n」を置く
+
+### ベースとなるドキュメントの作り方
 
 - web版の ~~Gemini2.5Pro~~ Gemini3Pro を用いる。
 - 以下のプロンプトで章立てを考えさせる
@@ -107,7 +135,6 @@ Cloudflare Worker のビルドログとステータス表示が見れますが
         Hello
         ```
         ````
-    - 練習問題の見出しは「この章のまとめ」の直下のレベル3見出しで、 `### 練習問題n` または `### 練習問題n: タイトル` とする
     - 練習問題のファイル名は不都合がなければ `practice(章番号)_(問題番号).拡張子` で統一。空でもよいのでファイルコードブロックとexecコードブロックを置く
 - 1章にはたぶん練習問題要らない。