コメントから句点を外し、README と「はじめに」を書き直す

コメント:
- 全言語のコメントから句点を取り除いた（2,666 行）
  文が続くものは行を分けて表す
- check_comments.py に句点の検査を足した
- Python の docstring は閉じ引用符を独立行にした

ドキュメント:
- 公開先やビルドの経緯にあたる記述を落とした
- README の表を 1 つにまとめ、太字を必要な箇所だけに絞った
- 「はじめに」5 ファイルの文体を「です・ます」で揃えた

全言語のテスト 743 件と適合性 779 件は変わらず通っている。

Author: tatuharu

.github/release-notes.md

@@ -1,8 +1,7 @@
 Minecraft **Java版 26.2**（DataVersion `4903`）のワールドデータ・NBTファイルを
 読み書きするライブラリです。
 
-パッケージレジストリへは公開していません。**下の成果物をダウンロードして、
-自分のプロジェクトへ組み込んでください。**
+下の成果物をダウンロードして、自分のプロジェクトへ組み込んでください。
 
 ## 成果物
 

README.md

@@ -4,86 +4,60 @@
 [![lint](https://github.com/ScriptArts/SpringNBTLibrary/actions/workflows/lint.yml/badge.svg)](https://github.com/ScriptArts/SpringNBTLibrary/actions/workflows/lint.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 
-Minecraft **Java版 26.2**（DataVersion `4903`）のワールドデータ・NBTファイルを読み書きするライブラリ。
-
-**複数の言語へ、同じ概念モデルと同じ挙動のものを提供する。**
+Minecraft Java版 26.2（DataVersion `4903`）のワールドデータ・NBTファイルを読み書きするライブラリです。
+複数の言語に、同じ概念モデルと同じ挙動のものを用意しています。
 
 ## 対応言語
 
-対応言語は今後も追加していく。現在対応しているのは次のとおり。
+[Releases](https://github.com/ScriptArts/SpringNBTLibrary/releases) から落として、自分のプロジェクトに組み込んでください。
 
-| 言語 | パッケージ名 | 必要環境 | はじめに |
+| 言語 | 必要環境 | 入手するもの | 組み込み方 |
 |---|---|---|---|
-| C# | `SpringNBTLibrary` | .NET 8 / C# 12 | [導入と最小サンプル](docs/getting-started/csharp.md) |
-| Java | `io.github.scriptarts:spring-nbt-library` | Java 21 (LTS) | [導入と最小サンプル](docs/getting-started/java.md) |
-| TypeScript | `spring-nbt-library` | Node.js 20+ / TypeScript 5.7+ | [導入と最小サンプル](docs/getting-started/typescript.md) |
-| Python | `spring-nbt-library` | Python 3.10+ | [導入と最小サンプル](docs/getting-started/python.md) |
-| Rust | `spring-nbt-library` | Rust 1.75+ (2021 edition) | [導入と最小サンプル](docs/getting-started/rust.md) |
+| [C#](docs/getting-started/csharp.md) | .NET 8 / C# 12 | `SpringNBTLibrary-<版>-dotnet8.zip` | 展開して `.dll` を参照に追加 |
+| [Java](docs/getting-started/java.md) | Java 21 (LTS) | `spring-nbt-library-<版>.jar` | クラスパスへ追加 |
+| [TypeScript](docs/getting-started/typescript.md) | Node.js 20+ | `spring-nbt-library-<版>.tgz` | `npm install ./<ファイル>` |
+| [Python](docs/getting-started/python.md) | Python 3.10+ | `spring_nbt_library-<版>-py3-none-any.whl` | `pip install <ファイル>` |
+| [Rust](docs/getting-started/rust.md) | Rust 1.75+ | — | `Cargo.toml` で git 参照 |
 
-新しい言語を足す手順は [移植ガイド](docs/contributing/porting-guide.md) にまとめてある。
-言語が増えても、仕様書とテストベクタは共通のものを使う。
+同梱の `SHA256SUMS.txt` でファイルの整合を確認できます。
 
-## 入手
+対応言語は今後も増やします。手順は [移植ガイド](docs/contributing/porting-guide.md) にあります。
 
-パッケージレジストリへは公開していない。
-**[Releases](https://github.com/ScriptArts/SpringNBTLibrary/releases) から
-ビルド済みの成果物を落として、自分のプロジェクトへ組み込む。**
+## 何が違うのか
 
-| 言語 | ファイル | 組み込み方 |
-|---|---|---|
-| C# | `SpringNBTLibrary-<版>-dotnet8.zip` | 展開して `.dll` を参照に追加 |
-| Java | `spring-nbt-library-<版>.jar` | クラスパスへ追加 |
-| TypeScript | `spring-nbt-library-<版>.tgz` | `npm install ./<ファイル>` |
-| Python | `spring_nbt_library-<版>-py3-none-any.whl` | `pip install <ファイル>` |
-| Rust | — | `Cargo.toml` で git 参照（`.crate` も置いてある） |
+NBT や Anvil を扱うライブラリは各言語にあります。
+このライブラリは、同じ仕様書と同じテストベクタから対応言語すべてを同時に作っています。
 
-同梱の `SHA256SUMS.txt` で、落としたファイルが壊れていないか確かめられる。
-言語ごとの詳しい手順は上の表の「はじめに」を参照。
+Rust のツールと Java のプラグインで同じワールドを触るとき、
+言語ごとに挙動の違うライブラリを組み合わせて悩まずに済むことを狙っています。
 
-## このライブラリの立ち位置
+そのために次を守っています。
 
-NBT や Anvil を扱うライブラリは各言語に既に存在する。
-本ライブラリの違いは、**同じ設計者が、同じ仕様書と同じテストベクタから、
-対応言語すべての実装を同時に提供している**点にある。
+- `docs/spec/` を唯一の正とし、各言語はその実装にすぎない
+- 挙動の一致は目視ではなく[適合性テスト](docs/spec/90-conformance.md)で確かめる
+- [機能一覧](docs/features.md)が実装からずれないよう CI で検査する
 
-複数言語が絡むプロジェクト（Rust のツールと Java のプラグインで同じワールドを扱う、など）で、
-言語ごとに挙動の違うライブラリを組み合わせて悩む必要をなくすことを狙っている。
+## ドキュメント
 
-そのため次を最優先で維持している。
+[目次](docs/README.md)から辿れます。
 
-1. `docs/spec/` が唯一の正であり、各言語実装はその実装であること
-2. 対応言語すべての挙動一致を、人手のレビューではなく**適合性テストで機械的に保証**すること
-3. [機能一覧](docs/features.md)が実装と乖離しないよう CI で検証すること
+| 読みたいこと | 場所 |
+|---|---|
+| 何ができるか | [機能一覧](docs/features.md) |
+| とりあえず動かす | [はじめに](docs/getting-started/) |
+| 使い方 | [ガイド](docs/guide/) |
+| 他言語版との対応 | [API対応表](docs/api/overview.md) |
+| 自分で実装・移植する | [仕様](docs/spec/00-conventions.md) |
+| 設計の理由 | [ADR](docs/adr/) |
 
-## ドキュメント
+## 検証
 
-**[ドキュメントの目次はこちら](docs/README.md)**
+NBT・Anvil・World の3レイヤを Java版 26.2 の実ワールドで確かめています。
+`.dat` 23個とチャンク 3,717個のすべてで、読み込みとバイト一致の書き戻しが通りました。
+World レイヤでも 3,481 チャンク（83,544 セクション）の再エンコードが原本と一致し、
+393万ブロックの読み出しに成功しています。
 
-| 目的 | 読むもの |
-|---|---|
-| 何ができるのか知りたい | [機能一覧](docs/features.md) |
-| とりあえず動かしたい | [はじめに](docs/getting-started/) |
-| 使い方を調べたい | [ガイド](docs/guide/) |
-| 他の言語版の対応するAPIを知りたい | [API対応表](docs/api/overview.md) |
-| 自分で実装・移植したい | [仕様](docs/spec/00-conventions.md) |
-| なぜその設計なのか知りたい | [設計判断の記録](docs/adr/) |
-
-## 対応状況
-
-| レイヤ | 内容 | 状態 |
-|---|---|---|
-| 1. NBT | 全13タグ・MUTF-8・圧縮・SNBT | ✅ 対応言語すべてで完成 |
-| 2. Anvil | `.mca` リージョンファイルの読み書き | ✅ 対応言語すべてで完成 |
-| 3. World / Block | `level.dat`・チャンク・ブロック操作 | ✅ 対応言語すべてで完成 |
-
-機能ごと・言語ごとの詳細は [機能一覧](docs/features.md) を参照。
-
-3レイヤすべて **Java版 26.2 の実ワールドで検証済み**。
-`.dat` 23個 + チャンク 3,717個 = 3,740件すべてで読み込みとバイト一致のラウンドトリップに成功し、
-World レイヤでも 3,481 チャンク（83,544 セクション）の再エンコードが原本と一致、
-393万ブロックの読み出しも通っています。
-代表ファイルは対応言語すべてで出力が完全一致することも確認済みです。
-自分のワールドで試すには:
+自分のワールドで試すこともできます。読み取りしかしません。
 
 ```bash
 python3 spec/tools/scan_world.py "<ワールドのパス>"

csharp/src/SpringNBTLibrary/Anvil/ChunkCompression.cs

@@ -1,37 +1,47 @@
 namespace SpringNBTLibrary.Anvil;
 
 /// <summary>
-/// リージョンファイル内でチャンクに使われる圧縮方式。値は仕様が定める圧縮方式IDと一致する。
+/// リージョンファイル内でチャンクに使われる圧縮方式
+/// 値は仕様が定める圧縮方式IDと一致する
 /// </summary>
 /// <remarks>
 /// <para>
-/// NBT 層の <see cref="Nbt.Compression"/> とは別物であることに注意。
-/// あちらはファイル全体の圧縮を表し、こちらはリージョン内の 1 チャンクに付く 1 バイトのIDを表す。
+/// NBT 層の <see cref="Nbt.Compression"/> とは別物であることに注意
+/// あちらはファイル全体の圧縮を表し、こちらはリージョン内の 1 チャンクに付く 1 バイトのIDを表す
 /// </para>
 /// <para>仕様: <c>docs/spec/20-anvil-region.md</c> 3.1章</para>
 /// </remarks>
 public enum ChunkCompression
 {
-    /// <summary>GZip (RFC 1952)。ID=1。実データではほぼ使われない。</summary>
+    /// <summary>GZip (RFC 1952)
+    /// ID=1
+    /// 実データではほぼ使われない</summary>
     Gzip = 1,
 
-    /// <summary>Zlib (RFC 1950)。ID=2。Minecraft が実際に書き出す方式。</summary>
+    /// <summary>Zlib (RFC 1950)
+    /// ID=2
+    /// Minecraft が実際に書き出す方式</summary>
     Zlib = 2,
 
-    /// <summary>無圧縮。ID=3。</summary>
+    /// <summary>無圧縮
+    /// ID=3</summary>
     None = 3,
 
-    /// <summary>LZ4（ブロック形式）。ID=4。任意依存。</summary>
+    /// <summary>LZ4（ブロック形式）
+    /// ID=4
+    /// 任意依存</summary>
     Lz4 = 4,
 
-    /// <summary>サードパーティ製サーバのカスタム方式。ID=127。中身は解釈できない。</summary>
+    /// <summary>サードパーティ製サーバのカスタム方式
+    /// ID=127
+    /// 中身は解釈できない</summary>
     Custom = 127,
 }
 
-/// <summary><see cref="ChunkCompression"/> の拡張メソッド。</summary>
+/// <summary><see cref="ChunkCompression"/> の拡張メソッド</summary>
 public static class ChunkCompressionExtensions
 {
-    /// <summary>適合性テストで言語間比較に使う識別子を返す。</summary>
+    /// <summary>適合性テストで言語間比較に使う識別子を返す</summary>
     public static string AsString(this ChunkCompression compression)
     {
         switch (compression)
@@ -53,9 +63,9 @@ public static string AsString(this ChunkCompression compression)
     }
 
     /// <summary>
-    /// 圧縮方式IDから <see cref="ChunkCompression"/> を得る。
+    /// 圧縮方式IDから <see cref="ChunkCompression"/> を得る
     /// </summary>
-    /// <exception cref="SpringNbtException">未知のIDの場合（<see cref="ErrorCode.MalformedData"/>）。</exception>
+    /// <exception cref="SpringNbtException">未知のIDの場合（<see cref="ErrorCode.MalformedData"/>）</exception>
     public static ChunkCompression FromId(int id)
     {
         // 仕様が定めるのは 1・2・3・4・127 の 5 種類だけ

csharp/src/SpringNBTLibrary/Anvil/ChunkPos.cs

@@ -3,35 +3,35 @@
 namespace SpringNBTLibrary.Anvil;
 
 /// <summary>
-/// チャンクの絶対座標。
+/// チャンクの絶対座標
 /// </summary>
 /// <remarks>仕様: <c>docs/spec/20-anvil-region.md</c> 1章</remarks>
 public readonly struct ChunkPos : IEquatable<ChunkPos>
 {
-    /// <summary>座標を指定して作る。</summary>
+    /// <summary>座標を指定して作る</summary>
     public ChunkPos(int x, int z)
     {
         X = x;
         Z = z;
     }
 
-    /// <summary>絶対チャンクX座標。</summary>
+    /// <summary>絶対チャンクX座標</summary>
     public int X { get; }
 
-    /// <summary>絶対チャンクZ座標。</summary>
+    /// <summary>絶対チャンクZ座標</summary>
     public int Z { get; }
 
-    /// <summary>このチャンクを含むリージョンの座標。</summary>
-    /// <remarks>算術右シフトなので負の座標でも正しく求まる。</remarks>
+    /// <summary>このチャンクを含むリージョンの座標</summary>
+    /// <remarks>算術右シフトなので負の座標でも正しく求まる</remarks>
     public RegionPos Region => new RegionPos(X >> 5, Z >> 5);
 
-    /// <summary>リージョン内でのX位置 (0..31)。</summary>
+    /// <summary>リージョン内でのX位置 (0..31)</summary>
     public int LocalX => X & 31;
 
-    /// <summary>リージョン内でのZ位置 (0..31)。</summary>
+    /// <summary>リージョン内でのZ位置 (0..31)</summary>
     public int LocalZ => Z & 31;
 
-    /// <summary>ロケーションテーブル内の添字 (0..1023)。</summary>
+    /// <summary>ロケーションテーブル内の添字 (0..1023)</summary>
     public int Index => LocalX + (LocalZ * 32);
 
     /// <inheritdoc/>
@@ -43,10 +43,10 @@ public ChunkPos(int x, int z)
     /// <inheritdoc/>
     public override int GetHashCode() => HashCode.Combine(X, Z);
 
-    /// <summary>2つの座標が等しいか。</summary>
+    /// <summary>2つの座標が等しいか</summary>
     public static bool operator ==(ChunkPos left, ChunkPos right) => left.Equals(right);
 
-    /// <summary>2つの座標が異なるか。</summary>
+    /// <summary>2つの座標が異なるか</summary>
     public static bool operator !=(ChunkPos left, ChunkPos right) => !left.Equals(right);
 
     /// <inheritdoc/>
@@ -55,29 +55,31 @@ public override string ToString() =>
 }
 
 /// <summary>
-/// リージョンの座標。1リージョンは 32×32 チャンクを担当する。
+/// リージョンの座標
+/// 1リージョンは 32×32 チャンクを担当する
 /// </summary>
 public readonly struct RegionPos : IEquatable<RegionPos>
 {
-    /// <summary>座標を指定して作る。</summary>
+    /// <summary>座標を指定して作る</summary>
     public RegionPos(int x, int z)
     {
         X = x;
         Z = z;
     }
 
-    /// <summary>リージョンX座標。</summary>
+    /// <summary>リージョンX座標</summary>
     public int X { get; }
 
-    /// <summary>リージョンZ座標。</summary>
+    /// <summary>リージョンZ座標</summary>
     public int Z { get; }
 
-    /// <summary>このリージョンのファイル名（<c>r.X.Z.mca</c>）。</summary>
+    /// <summary>このリージョンのファイル名（<c>r.X.Z.mca</c>）</summary>
     public string FileName =>
         string.Create(CultureInfo.InvariantCulture, $"r.{X}.{Z}.mca");
 
     /// <summary>
-    /// <c>r.X.Z.mca</c> 形式のファイル名から座標を得る。解釈できなければ null。
+    /// <c>r.X.Z.mca</c> 形式のファイル名から座標を得る
+    /// 解釈できなければ null
     /// </summary>
     public static RegionPos? FromFileName(string fileName)
     {
@@ -113,10 +115,10 @@ public RegionPos(int x, int z)
     /// <inheritdoc/>
     public override int GetHashCode() => HashCode.Combine(X, Z);
 
-    /// <summary>2つの座標が等しいか。</summary>
+    /// <summary>2つの座標が等しいか</summary>
     public static bool operator ==(RegionPos left, RegionPos right) => left.Equals(right);
 
-    /// <summary>2つの座標が異なるか。</summary>
+    /// <summary>2つの座標が異なるか</summary>
     public static bool operator !=(RegionPos left, RegionPos right) => !left.Equals(right);
 
     /// <inheritdoc/>

csharp/src/SpringNBTLibrary/Anvil/RawChunk.cs

@@ -1,18 +1,19 @@
 namespace SpringNBTLibrary.Anvil;
 
 /// <summary>
-/// リージョンファイルに格納されたままの、圧縮済みチャンクデータ。
+/// リージョンファイルに格納されたままの、圧縮済みチャンクデータ
 /// </summary>
 /// <remarks>
 /// <para>
 /// 本ライブラリが解釈できない圧縮方式（LZ4 未導入、カスタム方式）でも
-/// これなら取り出せる。バックアップや別ツールへの受け渡しに使う。
+/// これなら取り出せる
+/// バックアップや別ツールへの受け渡しに使う
 /// </para>
 /// <para>仕様: <c>docs/spec/20-anvil-region.md</c> 5章</para>
 /// </remarks>
 public sealed class RawChunk
 {
-    /// <summary>圧縮方式と本体を指定して作る。</summary>
+    /// <summary>圧縮方式と本体を指定して作る</summary>
     public RawChunk(ChunkCompression compression, byte[] data, bool external = false)
     {
         ArgumentNullException.ThrowIfNull(data);
@@ -21,18 +22,18 @@ public RawChunk(ChunkCompression compression, byte[] data, bool external = false
         External = external;
     }
 
-    /// <summary>この本体に使われている圧縮方式。</summary>
+    /// <summary>この本体に使われている圧縮方式</summary>
     public ChunkCompression Compression { get; }
 
-    /// <summary>圧縮されたままの本体。</summary>
+    /// <summary>圧縮されたままの本体</summary>
     public byte[] Data { get; }
 
     /// <summary>
-    /// 外部ファイル <c>c.X.Z.mcc</c> に格納されていたか。
+    /// 外部ファイル <c>c.X.Z.mcc</c> に格納されていたか
     /// </summary>
     /// <remarks>
-    /// 書き込み時にこの値を指定する必要はない。
-    /// サイズに応じて <see cref="RegionFile"/> が自動的に判断する。
+    /// 書き込み時にこの値を指定する必要はない
+    /// サイズに応じて <see cref="RegionFile"/> が自動的に判断する
     /// </remarks>
     public bool External { get; }