レビューコメント対応

主に以下の観点で指摘をいただき、修正しました。
* 訳抜け
* 日本語として違和感のある表現
* 誤った意訳

Co-authored-by: Soichiro Miki <[email protected]>

Author: kenji-arata

src/content/reference/react-compiler/compilationMode.md

@@ -37,8 +37,8 @@ React Compiler が最適化する関数を決定する方法を制御します
 #### Options {/*options*/}
 
 - **`'infer'`**（デフォルト）：コンパイラは高度なヒューリスティックを使用して React コンポーネントとフックを識別します。
-  - `"use memo"` ディレクティブで明示的に注釈された関数
-  - コンポーネント（パスカルケース）やフック（`use` プレフィックス）のように命名され、かつ JSX を作成または他のフックを呼び出す関数
+  - `"use memo"` ディレクティブで明示的にアノテーションされた関数
+  - コンポーネント（パスカルケース）やフック（`use` プレフィックス）の規約で命名され、かつ、JSX の作成あるいは他のフックの呼び出しを行っている関数
 
 - **`'annotation'`**： `"use memo"` ディレクティブで明示的にマークされた関数のみをコンパイルします。段階的導入に最適です。
 
@@ -49,7 +49,7 @@ React Compiler が最適化する関数を決定する方法を制御します
 #### 注意点 {/*caveats*/}
 
 - `'infer'` モードでは、関数が検出されるために React の命名規則に従う必要があります。
-- `'all'` モードを使用すると、ユーティリティ関数をコンパイルすることでパフォーマンスに悪影響を与える可能性があります。
+- `'all'` モードを使用すると、ユーティリティ関数がコンパイルされるためにパフォーマンスに悪影響を与える可能性があります。
 - `'syntax'` モードでは Flow が必要で、TypeScript では動作しません。
 - モードに関係なく、`"use no memo"` ディレクティブを持つ関数は常にスキップされます。
 
@@ -59,7 +59,7 @@ React Compiler が最適化する関数を決定する方法を制御します
 
 ### デフォルト推論モード {/*default-inference-mode*/}
 
-デフォルトの `'infer'` モードは、React の慣例に従う大抵のコードベースでうまく動作します。
+デフォルトの `'infer'` モードは、React の慣習に従う大抵のコードベースでうまく動作します。
 
 ```js
 {
@@ -93,7 +93,7 @@ function calculateTotal(items) {
 }
 ```
 
-### 注釈を使用した段階的な導入 {/*incremental-adoption*/}
+### アノテーションを使用した段階的な導入 {/*incremental-adoption*/}
 
 段階的な移行では、マークされた関数のみをコンパイルするために `'annotation'` モードを使用してください。
 
@@ -103,7 +103,7 @@ function calculateTotal(items) {
 }
 ```
 
-次に、コンパイルする関数を明示的にマークします。
+その後に、コンパイルする関数を明示的にマークしていきます。
 
 ```js
 // Only this function will be compiled
@@ -126,7 +126,7 @@ function NormalComponent(props) {
 
 ### Flow syntax モードの使用方法 {/*flow-syntax-mode*/}
 
-コードベースで TypeScript の代わりに Flow を使用している場合は、本セクションを参照ください。
+コードベースで TypeScript ではなく Flow を使用している場合は、以下のようにします。
 
 ```js
 {
@@ -173,9 +173,9 @@ function ComponentWithSideEffects() {
 
 ## トラブルシューティング {/*troubleshooting*/}
 
-### infer モードでコンポーネントがコンパイルされない場合 {/*component-not-compiled-infer*/}
+### infer モードでコンポーネントがコンパイルされない {/*component-not-compiled-infer*/}
 
-`'infer'` モードでは、コンポーネントが React の慣例に従っていることを確認してください。
+`'infer'` モードでは、コンポーネントが React の慣習に従っていることを確認してください。
 
 ```js
 // ❌ Won't be compiled: lowercase name

src/content/reference/react-compiler/configuration.md

@@ -33,7 +33,7 @@ module.exports = {
 
 これらのオプションは、コンパイラが*何を*最適化し、*どのように*コンポーネントとフックを選択してコンパイルするかを制御します。
 
-* [`compilationMode`](/reference/react-compiler/compilationMode) は、コンパイルする関数を選択する方法を制御します。（例：すべての関数、注釈付きのもののみ、インテリジェント検出など）
+* [`compilationMode`](/reference/react-compiler/compilationMode) は、コンパイルする関数を選択する方法を制御します（例：すべての関数、アノテーション付きのもののみ、インテリジェント検出など）。
 
 ```js
 {
@@ -45,7 +45,7 @@ module.exports = {
 
 ## バージョン互換性 {/*version-compatibility*/}
 
-React のバージョン設定により、コンパイラが使用中の React バージョンと互換性のあるコードが生成されることが保証されます。
+React バージョンの設定により、使用中の React バージョンと互換性のあるコードをコンパイラが生成することが保証されます。
 
 [`target`](/reference/react-compiler/target) は、使用中の React バージョン（17、18、19）を指定します。
 
@@ -60,7 +60,7 @@ React のバージョン設定により、コンパイラが使用中の React 
 
 ## エラーハンドリング {/*error-handling*/}
 
-これらのオプションは、コンパイラが [Rules of React](/reference/rules) に従わないコードに対し、どのように応答するか制御します。
+これらのオプションは、コンパイラが [React のルール](/reference/rules)に従わないコードをどのように処理するか制御します。
 
 [`panicThreshold`](/reference/react-compiler/panicThreshold) は、ビルドを失敗させるか、問題のあるコンポーネントをスキップするかを決定します。
 
@@ -77,7 +77,7 @@ React のバージョン設定により、コンパイラが使用中の React 
 
 ログと解析オプションは、コンパイラが何を行っているのか理解するのに役立ちます。
 
-[`logger`](/reference/react-compiler/logger) は、コンパイルイベントのカスタムログを提供します。
+[`logger`](/reference/react-compiler/logger) は、コンパイルイベントに対するカスタムのロギング手段を指定します。
 
 ```js
 {

src/content/reference/react-compiler/gating.md

@@ -4,7 +4,7 @@ title: gating
 
 <Intro>
 
-`gating` オプションは条件付きコンパイルを有効にし、最適化されたコードがランタイムでいつ使用されるか制御することができます。
+`gating` オプションは条件付きコンパイルを有効にし、最適化されたコードがランタイムでいつ使用されるか制御できるようにします。
 
 </Intro>
 
@@ -47,15 +47,15 @@ title: gating
 
 #### 注意点 {/*caveats*/}
 
-- gating 関数は boolean を返す必要があります。
+- ゲーティング関数はブーリアンを返す必要があります。
 - コンパイル済みバージョンと元のバージョンの両方を含めるため、バンドルサイズが増加します。
 - コンパイルされた関数を含むすべてのファイルでインポートされます。
 
 ---
 
 ## 使用法 {/*usage*/}
 
-### 基本的なセットアップ {/*basic-setup*/}
+### 基本的なフィーチャーフラグのセットアップ {/*basic-setup*/}
 
 1. フィーチャーフラグモジュールを作成します。
 
@@ -78,7 +78,7 @@ export function shouldUseCompiler() {
 }
 ```
 
-3. コンパイラは gated コードを生成します。
+3. コンパイラがゲーティング済みのコードを生成します。
 
 ```js
 // Input
@@ -94,13 +94,13 @@ const Button = shouldUseCompiler()
   : function Button_original(props) { /* original version */ };
 ```
 
-gating 関数はモジュール時に一度だけ評価されます。そのため JS バンドルが解析・評価されると、コンポーネントの選択はブラウザセッションの残りの期間、静的に維持されるので注意してください。
+ゲーティング関数はモジュール評価時に一度だけ評価されることに注意してください。JS バンドルがパース・評価された時点でコンポーネントの選択が固定され、ブラウザセッションが持続する間、静的に維持されます。
 
 ---
 
 ## トラブルシューティング {/*troubleshooting*/}
 
-### フィーチャーフラグが動作しない場合 {/*flag-not-working*/}
+### フィーチャーフラグが動作しない {/*flag-not-working*/}
 
 フラグモジュールが正しい関数をエクスポートしているか確認してください。
 
@@ -116,7 +116,7 @@ export function shouldUseCompiler() {
 }
 ```
 
-### インポートエラーが発生する場合 {/*import-errors*/}
+### インポートエラーが発生する {/*import-errors*/}
 
 ソースのパスが正しいことを確認してください。
 

src/content/reference/react-compiler/logger.md

@@ -4,7 +4,7 @@ title: logger
 
 <Intro>
 
-`logger` オプションは、コンパイル中の React Compiler イベントのカスタムログを提供します。
+`logger` オプションで、コンパイル時に起こる React Compiler のイベントに対するカスタムロガーを指定します。
 
 </Intro>
 
@@ -26,7 +26,7 @@ title: logger
 
 ### `logger` {/*logger*/}
 
-コンパイラの動作を追跡し、エラーをデバッグするためのカスタムログを設定します。
+コンパイラの動作を追跡しエラーをデバッグするための、カスタムのロギング方法を設定します。
 
 #### Type {/*type*/}
 
@@ -42,7 +42,7 @@ title: logger
 
 #### Methods {/*methods*/}
 
-- **`logEvent`**: 各コンパイライベントに対して、ファイル名とイベント詳細と共に呼び出されます。
+- **`logEvent`**: 各コンパイライベントに対して、ファイル名およびイベント詳細を引数にして呼び出される。
 
 #### イベントタイプ {/*event-types*/}
 
@@ -60,7 +60,7 @@ title: logger
 
 ---
 
-## 使用方法 {/*usage*/}
+## 使用法 {/*usage*/}
 
 ### 基本的なログ {/*basic-logging*/}
 

src/content/reference/react-compiler/panicThreshold.md

@@ -34,22 +34,22 @@ title: panicThreshold
 
 `'none'`
 
-#### オプション {/*options*/}
+#### 指定可能な値 {/*options*/}
 
-- **`'none'`**（デフォルト、推奨）：コンパイルできないコンポーネントをスキップしてビルドを継続します。
-- **`'critical_errors'`**：クリティカルなコンパイラエラーの場合のみビルドを失敗します。
-- **`'all_errors'`**：コンパイラの診断情報があればビルドを失敗します。
+- **`'none'`**（デフォルト、推奨）: コンパイルできないコンポーネントをスキップしてビルドを継続する。
+- **`'critical_errors'`**: クリティカルなコンパイラエラーの場合のみビルドを失敗させる。
+- **`'all_errors'`**: コンパイラの診断情報がある場合常にビルドを失敗させる。
 
 #### 注意点 {/*caveats*/}
 
 - 本番ビルドでは常に `'none'` を使用してください。
-- ビルドの失敗により、アプリケーションのビルドが妨げられます。
-- コンパイラは `'none'` で問題のあるコードを自動的に検出してスキップします。
+- ビルドが失敗すると、アプリケーションのビルドも失敗します。
+- `'none'` の場合、コンパイラは問題のあるコードを自動的に検出してスキップします。
 - より高い閾値は開発中のデバッグ時にのみ有用です。
 
 ---
 
-## 使用方法 {/*usage*/}
+## 使用法 {/*usage*/}
 
 ### 本番設定（推奨） {/*production-configuration*/}
 
@@ -65,7 +65,7 @@ title: panicThreshold
 - コンパイラの問題でビルドが失敗することはありません。
 - 最適化できないコンポーネントは通常通り実行されます。
 - 最大数のコンポーネントが最適化されます。
-- 安定した本番デプロイがされます。
+- 安定した本番デプロイが行われます。
 
 ### 開発時のデバッグ {/*development-debugging*/}
 

src/content/reference/react-compiler/target.md

@@ -36,22 +36,22 @@ title: target
 
 #### 有効な値 {/*valid-values*/}
 
-- **`'19'`**：React 19 が対象（デフォルト）。追加のランタイムパッケージは不要です。
-- **`'18'`**：React 18 が対象。`react-compiler-runtime` パッケージが必要です。
-- **`'17'`**：React 17 が対象。`react-compiler-runtime` パッケージが必要です。
+- **`'19'`**：React 19 がターゲット（デフォルト）。追加のランタイムパッケージは不要です。
+- **`'18'`**：React 18 がターゲット。`react-compiler-runtime` パッケージが必要です。
+- **`'17'`**：React 17 がターゲット。`react-compiler-runtime` パッケージが必要です。
 
 #### 注意点 {/*caveats*/}
 
-- 数値ではなく文字列値を使用してください。（例： `17` ではなく `'17'` です）
-- パッチバージョンを含めないでください。（例： `'18.2.0'`ではなく`'18'` です）
-- React 19 にはビルトインのコンパイラランタイム API が含まれます。
+- 数値ではなく文字列値を使用してください。（例：`17` ではなく `'17'`）
+- パッチバージョンを含めないでください。（例：`'18.2.0'` ではなく `'18'`）
+- React 19 にはコンパイラランタイム API が組み込みで含まれています。
 - React 17 と 18 では `react-compiler-runtime@latest` のインストールが必要です。
 
 ---
 
-## 使用方法 {/*usage*/}
+## 使用法 {/*usage*/}
 
-### React 19 が対象の場合（デフォルト） {/*targeting-react-19*/}
+### React 19 がターゲットの場合（デフォルト） {/*targeting-react-19*/}
 
 React 19 では特別な設定は不要です。
 
@@ -61,7 +61,7 @@ React 19 では特別な設定は不要です。
 }
 ```
 
-コンパイラは React 19 のビルトインランタイム API を使用します。
+コンパイラは React 19 組み込みのランタイム API を使用します。
 
 ```js
 // Compiled output uses React 19's native APIs
@@ -78,7 +78,7 @@ React 17 と React 18 のプロジェクトでは、2 つのステップが必
 npm install react-compiler-runtime@latest
 ```
 
-2. 対象を設定します。
+2. ターゲットを設定します。
 
 ```js
 // For React 18
@@ -105,7 +105,7 @@ import { c as _c } from 'react-compiler-runtime';
 
 ### コンパイラのランタイムが不足していることに関するランタイムエラー {/*missing-runtime*/}
 
-"Cannot find module 'react/compiler-runtime'" のようなエラーが表示される場合
+"Cannot find module 'react/compiler-runtime'" のようなエラーが表示される場合は以下のようにします。
 
 1. React バージョンを確認してください。
    ```bash
@@ -124,18 +124,18 @@ import { c as _c } from 'react-compiler-runtime';
    }
    ```
 
-### ランタイムパッケージが動作しない場合 {/*runtime-not-working*/}
+### ランタイムパッケージが動作しない {/*runtime-not-working*/}
 
 ランタイムパッケージが以下を満たしていることを確認してください。
 
-1. プロジェクト内にインストールされていること。（グローバルではないこと）
-2. `package.json` の依存関係に記載されていること。
+1. プロジェクト内にインストールされていること（グローバルではないこと）。
+2. `package.json` の依存ライブラリとして記載されていること。
 3. 正しいバージョンであること。（`@latest` タグ）
-4. `devDependencies` に含まれていないこと。（ランタイムで必要です）
+4. `devDependencies` に含まれていないこと（ランタイム時に必要なため）。
 
 ### コンパイル済み出力の確認 {/*checking-output*/}
 
-正しいランタイムが使用されていることを確認するには、異なるインポートに注目してください。（組み込み版は `react/compiler-runtime`、React 17/18 のスタンドアロンパッケージ版では `react-compiler-runtime`）
+正しくランタイムが使用されていることを確認するには、インポートが変わっていることに注目してください（組み込み版は `react/compiler-runtime`、React 17/18 のスタンドアロンパッケージ版では `react-compiler-runtime`）。
 
 ```js
 // For React 19 (built-in runtime)