summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorCliff Click <cliffc@acm.org>2026-10-07 09:53:15 -0700
committerCliff Click <cliffc@acm.org>2026-10-07 09:53:15 -0700
commitb2862f980f3d78012066ef1cc09d4ad58f886c0f (patch)
treebbeab7de6ac8b556911d117989ab4bbc0324ecb5 /docs
parent863a6ed0ad723e06c76f392d4fb3a5f6bd22863c (diff)
downloadSimple-pr262-doc-followups.tar.gz
Simple-pr262-doc-followups.zip
Pick up japanese transaltionpr262-doc-followups
A bunch of minor README fixes, missing TOC, grammer cleanup
Diffstat (limited to 'docs')
-rw-r--r--docs/chapter-backports.md4
-rw-r--r--docs/japanese-translation.md22
2 files changed, 24 insertions, 2 deletions
diff --git a/docs/chapter-backports.md b/docs/chapter-backports.md
index 53fd6a9c..220bc073 100644
--- a/docs/chapter-backports.md
+++ b/docs/chapter-backports.md
@@ -84,8 +84,8 @@ nullable field's implicit null is still an instance field.
Constructor permissions cover only allocation fields, including assignments in
nested blocks. They do not permit rebinding surrounding or constructor-local
fixed variables. Chapter 25's constructor-exit check also handles required
-primitive fields. The object format changes to `C0D2`; rebuilding `sys.o` is
-required and exercised by its native tests.
+primitive fields. The object layout changes under the unversioned `C0DE` header;
+rebuilding `sys.o` is required and exercised by its native tests.
The changed graphs exposed two small existing assumptions: Chapter 24 must
recognize a Phi whose own backedge is still under construction, and a memory
diff --git a/docs/japanese-translation.md b/docs/japanese-translation.md
new file mode 100644
index 00000000..39383345
--- /dev/null
+++ b/docs/japanese-translation.md
@@ -0,0 +1,22 @@
+# Japanese translation / 翻訳の保守方針
+
+English is authoritative. The contributed Japanese translation is maintained on
+a best-effort basis; English edits and chapter reorganizations never wait for
+translation updates. Move Japanese files and update navigation when renumbering
+chapters; prose updates can follow separately. Contributions are welcome, without
+an ongoing maintenance obligation for the original translator.
+
+[英語版](../README.md)が正式な文書です。この日本語訳は寄贈されたもので、可能な範囲で保守されますが、
+英語版より更新が遅れることがあります。英語版の編集や章の再構成を、翻訳の更新待ちにすることはありません。
+章を移動・改番する際は、日本語ファイルも一緒に移動して章の見出しやリンクを更新し、本文の翻訳は後から更新できます。
+翻訳の改善は歓迎しますが、元の寄贈者に継続的な保守を義務付けるものではありません。
+
+初回の翻訳は英語版のコミット
+[`81b654d7`](https://github.com/SeaOfNodes/Simple/tree/81b654d76444d747fdf1d053760e507b50f26e18)
+を基にしています。2026年10月の目次・文法見出し・コード例・命令エンコーディング・
+`C0DE` ヘッダに関する文書修正も反映しています。
+各文書の English リンクは現在の英語版を指します。更新されていない箇所の原文を確認するには、
+上記コミットの対応するファイルを参照してください。新しい章が未翻訳の場合は、その旨を示して英語版にリンクできます。
+
+
+[日本語の紹介に戻る](../README.ja.md)