docs: Improve document

- @snippetのサンプルコードを追加
- シールクラスの記述をブラッシュアップ
- レコードパターンの記載を校正
- switchのパターンマッチングのコードサンプルでNullPointerExceptionが出てしまう場合を考慮
- switch文のコード例でインデント不正を修正

Author: shout-star

documents/forJava/Javaコーディング規約.md

@@ -522,6 +522,29 @@ head:
        ソースコード管理システムで管理されている
 - サンプルコードを記載する場合は、`{@snippet}`タグを利用する。
 
+  外部ファイルから引用する例：
+
+  ```java
+  /**
+   * ユーザー登録処理の例
+   * {@snippet file="UserRegistrationExample.java" region="registration"}
+   */
+  ```
+
+  インラインでサンプルコードを記載する例：
+
+  ```java
+  /**
+   * ユーザー登録処理の例
+   * {@snippet :
+   * User user = new User();
+   * user.setName("田中太郎");
+   * user.setEmail("tanaka@example.com");
+   * userRepository.save(user);
+   * }
+   */
+  ```
+
 ## インポート
 
 - `java.lang`パッケージはインポートしない
@@ -1521,8 +1544,8 @@ head:
   boolean off = false;
   switch (day) {
       case SUNDAY, SATURDAY:
-        off = true;
-        break;
+          off = true;
+          break;
   };
   ```
 
@@ -1534,8 +1557,8 @@ head:
   switch (day) {
       case SUNDAY:
       case SATURDAY:
-        off = true;
-        break;
+          off = true;
+          break;
   };
   ```
 
@@ -1552,7 +1575,7 @@ head:
           case Long l    -> String.format("long %d", l);
           case Double d  -> String.format("double %f", d);
           case String s  -> String.format("String %s", s);
-          default        -> obj.toString();
+          default        -> Objects.toString(obj);
       };
   }
   ```
@@ -2073,7 +2096,8 @@ head:
 
 ## レコードパターン
 
-- データの分解と型チェックを同時に行えるレコードパターンは、コードの可読性と安全性を向上させるため、レコードを使用する場合はレコードパターンを用いて記述することを推奨する。
+- レコードパターンは、データの分解と型チェックを同時に行えるため、冗長なコードの削減、型安全性の向上、IDEによる補完やリファクタリング支援などのメリットがあります。  
+  これにより、コードの可読性・保守性・安全性が高まるため、レコードを使用する場合はレコードパターンを用いて記述することを推奨します。
 
   良い例：
 
@@ -2099,7 +2123,20 @@ head:
 
 - 明確な方針で、利用する・利用しないを統一すること  
   方針無く、`sealed`を利用するとコードの保守性や柔軟性が悪くなります。  
-  各プロジェクトで、`sealed`を利用しないか、`sealed`を利用しても良い箇所について方針を決めた上で使用するようにしてください。 (例：プロジェクト内で使用する共通機能ライブラリに限定して使用する。)
+  各プロジェクトで、`sealed`を利用しないか、`sealed`を利用しても良い箇所について方針を決めた上で使用するようにしてください。
+
+  方針例：
+  - プロジェクト内で使用する共通機能ライブラリに限定して使用する
+  - 外部公開APIでは禁止し、内部ユーティリティやドメイン層のみ許可する
+  - サードパーティ連携部分では利用しない
+  - 全体で利用しない
+    など、用途や公開範囲に応じて具体的な方針を決めてください。
+
+  **【補足：シールクラス（sealed classes）とは】**  
+  Javaのsealedクラスは、継承できるサブクラスを明示的に制限する仕組みです。  
+  これにより、ドメインモデルの制約強化やパターンマッチングの網羅性チェックが可能となり、意図しない拡張や誤用を防ぐことができます。  
+  典型的な利用例としては、状態や種類が限定されるドメイン（例：イベント種別、計算式のノード型など）の表現や、パターンマッチング（switch文・式）で全ケースを網羅的に扱いたい場合などが挙げられます。  
+  メリットは安全性・可読性の向上ですが、柔軟な拡張が難しくなるデメリットもあるため、利用方針を明確に定めてください。
 
 ## テキストブロック