@aigne/doc-smith 0.8.11-beta.6 → 0.8.11

package/docs/features-translate-documentation.zh-TW.md

@@ -1,45 +1,46 @@
 # 翻譯文件
 
-AIGNE DocSmith 可以將您的文件翻譯成 12 種不同的語言，包括英文、中文和西班牙文，讓您的專案能觸及全球受眾。此工具提供兩種方式來管理翻譯：一種是用於引導式設定的互動模式，另一種是透過命令列參數進行精確控制和自動化。
+AIGNE DocSmith 可以將您的文件翻譯成 12 種不同的語言，包括英文、中文和西班牙文，讓您的專案能觸及全球受眾。該工具提供兩種管理翻譯的方式：用於引導式設定的互動模式，以及用於精確控制和自動化的命令列參數。
 
 ## 互動式翻譯
 
-若要獲得引導式體驗，請在不帶任何參數的情況下執行 `translate` 命令。這對於偏好逐步操作流程的使用者來說非常理想。
+若要獲得引導式體驗，請執行不含任何參數的 `translate` 命令。此方法非常適合偏好逐步操作的使用者。
 
 ```bash
 aigne doc translate
 ```
 
-此命令會啟動一個互動式精靈，引導您完成整個流程：
+此命令會啟動一個互動式精靈，引導您完成整個過程：
 
-1.  **選取要翻譯的文件：** 您將看到現有文件的列表。使用空白鍵選取您想翻譯的文件。
+1.  **選擇要翻譯的文件：** 系統會顯示您現有文件的列表。使用空格鍵選擇您要翻譯的文件。
 
-    ![選取要翻譯的文件](https://docsmith.aigne.io/image-bin/uploads/e2cf5fa45aa856c406a444fb4665ed2d.png)
+    ![選擇要翻譯的文件](../assets/screenshots/doc-translate.png)
 
-2.  **選擇目標語言：** 選取文件後，從支援的選項列表中選擇一種或多種目標語言。
+2.  **選擇目標語言：** 選擇文件後，從支援的選項列表中選擇一種或多種目標語言。
 
-    ![選擇要翻譯的語言](https://docsmith.aigne.io/image-bin/uploads/2e243a2488f2060a693fe0ac0c8fb5ad.png)
+    ![選擇要翻譯成的語言](../assets/screenshots/doc-translate-langs.png)
 
-3.  **確認並執行：** DocSmith 接著會處理翻譯，為您選擇的每種語言生成所選文件的新版本。
+3.  **確認並執行：** DocSmith 隨後會處理翻譯，為您選擇的每個檔案生成對應各種語言的新版本。
 
 ## 命令列翻譯
 
-對於腳本或 CI/CD 管線中的自動化，請使用命令列旗標來控制翻譯流程。此方法適合開發人員和進階使用者。
+對於在腳本或 CI/CD 流程中進行自動化，請使用命令列旗標來控制翻譯過程。此方法為開發人員和進階使用者提供了更大的靈活性。
 
 ### 命令參數
 
 <x-field-group>
-  <x-field data-name="--langs" data-type="string" data-required="false" data-desc="指定一種目標語言。此旗標可多次使用以包含多種語言（例如：--langs zh --langs ja）。"></x-field>
-  <x-field data-name="--docs" data-type="string" data-required="false" data-desc="指定要翻譯的文件的路徑。此旗標也可多次使用以進行批次翻譯。"></x-field>
-  <x-field data-name="--feedback" data-type="string" data-required="false" data-desc="向 AI 提供建議以引導翻譯品質（例如：--feedback &quot;使用正式語氣&quot;）。"></x-field>
-  <x-field data-name="--glossary" data-type="string" data-required="false" data-desc="使用 Markdown 格式的詞彙表檔案，以確保特定術語的一致性（例如：--glossary @path/to/glossary.md）。"></x-field>
+  <x-field data-name="--langs" data-type="string" data-required="false" data-desc="指定一種目標語言。此旗標可多次使用以包含多種語言（例如，--langs zh --langs ja）。"></x-field>
+  <x-field data-name="--docs" data-type="string" data-required="false" data-desc="指定要翻譯的文件路徑。此旗標也可多次使用以進行批次翻譯。"></x-field>
+  <x-field data-name="--feedback" data-type="string" data-required="false" data-desc="向 AI 提供建議以引導翻譯品質（例如，--feedback &quot;使用正式語氣&quot;）。"></x-field>
+  <x-field data-name="--glossary" data-type="string" data-required="false" data-desc="使用 Markdown 格式的詞彙表檔案，以確保特定術語的一致性（例如，--glossary @path/to/glossary.md）。"></x-field>
+  <x-field data-name="--model" data-type="string" data-required="false" data-desc="指定要使用的翻譯模型，例如 'openai:gpt-4o' 或 'google:gemini-2.5-pro'。"></x-field>
 </x-field-group>
 
 ### 範例
 
 #### 翻譯特定文件
 
-要將 `overview.md` 和 `examples.md` 翻譯成中文和日文，請執行：
+若要將 `overview.md` 和 `examples.md` 翻譯成中文和日文，請執行以下命令：
 
 ```bash
 aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
@@ -53,29 +54,37 @@ aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
 aigne doc translate --glossary @path/to/glossary.md --feedback "Use technical terminology consistently" --docs overview.md --langs de
 ```
 
+#### 指定翻譯模型
+
+若要使用特定的 AI 模型執行翻譯任務，請使用 `--model` 旗標。
+
+```bash
+aigne doc translate --docs overview.md --langs fr --model openai:gpt-4o
+```
+
 ## 支援的語言
 
 DocSmith 支援以下 12 種語言的自動翻譯：
 
-| 語言             | 代碼    |
+| 語言               | 代碼    |
 | -------------------- | ------- |
-| 英文              | `en`    |
-| 簡體中文   | `zh-CN` |
-| 繁體中文  | `zh-TW` |
-| 日文             | `ja`    |
-| 韓文               | `ko`    |
-| 西班牙文              | `es`    |
-| 法文               | `fr`    |
-| 德文               | `de`    |
-| 葡萄牙文           | `pt-BR` |
-| 俄文              | `ru`    |
-| 義大利文              | `it`    |
-| 阿拉伯文               | `ar`    |
+| 英文                 | `en`    |
+| 簡體中文             | `zh-CN` |
+| 繁體中文             | `zh-TW` |
+| 日文                 | `ja`    |
+| 韓文                 | `ko`    |
+| 西班牙文             | `es`    |
+| 法文                 | `fr`    |
+| 德文                 | `de`    |
+| 葡萄牙文             | `pt-BR` |
+| 俄文                 | `ru`    |
+| 義大利文             | `it`    |
+| 阿拉伯文             | `ar`    |
 
 ---
 
 文件翻譯完成後，您就可以與全世界分享了。
 
 <x-card data-title="下一步：發佈您的文件" data-icon="lucide:upload-cloud" data-href="/features/publish-your-docs" data-cta="閱讀更多">
-  關於如何將您的文件發佈到公共平台或您自己的私人網站的指南。
+  關於如何輕鬆將您的文件發佈到公共平台或您自己的私人網站的指南。
 </x-card>

package/docs/features-translate-documentation.zh.md

@@ -1,10 +1,10 @@
 # 翻译文档
 
-AIGNE DocSmith 可以将您的文档翻译成 12 种不同的语言，包括英语、中文和西班牙语，让您的项目能够触及全球受众。该工具提供两种管理翻译的方式：用于引导式设置的交互模式和用于精确控制与自动化的命令行参数。
+AIGNE DocSmith 可以将您的文档翻译成 12 种不同的语言，包括英语、中文和西班牙语，让您的项目触达全球受众。该工具提供两种管理翻译的方式：用于引导式设置的交互模式和用于精确控制和自动化的命令行参数。
 
 ## 交互式翻译
 
-如需引导式体验，请直接运行 `translate` 命令，无需任何参数。这非常适合偏好分步操作的用户。
+要获得引导式体验，请在不带任何参数的情况下运行 `translate` 命令。此方法非常适合偏好分步操作的用户。
 
 ```bash
 aigne doc translate
@@ -12,34 +12,35 @@ aigne doc translate
 
 此命令会启动一个交互式向导，引导您完成整个过程：
 
-1.  **选择要翻译的文档：** 系统将显示您现有文档的列表。使用空格键选择您想要翻译的文档。
+1.  **选择要翻译的文档：** 您将看到一个现有文档的列表。使用空格键选择您想要翻译的文档。
 
-    ![选择要翻译的文档](https://docsmith.aigne.io/image-bin/uploads/e2cf5fa45aa856c406a444fb4665ed2d.png)
+    ![选择要翻译的文档](../assets/screenshots/doc-translate.png)
 
-2.  **选择目标语言：** 选择文档后，从支持的语言列表中选择一个或多个目标语言。
+2.  **选择目标语言：** 选择文档后，从支持的选项列表中选择一种或多种目标语言。
 
-    ![选择翻译的目标语言](https://docsmith.aigne.io/image-bin/uploads/2e243a2488f2060a693fe0ac0c8fb5ad.png)
+    ![选择要翻译成的语言](../assets/screenshots/doc-translate-langs.png)
 
 3.  **确认并运行：** DocSmith 随后将处理翻译，为每个选定的语言生成所选文件的新版本。
 
 ## 命令行翻译
 
-对于脚本或 CI/CD 管道中的自动化，可使用命令行标志来控制翻译过程。此方法适合开发人员和高级用户。
+要在脚本或 CI/CD 管道中实现自动化，请使用命令行标志来控制翻译过程。此方法为开发人员和高级用户提供了更大的灵活性。
 
 ### 命令参数
 
 <x-field-group>
-  <x-field data-name="--langs" data-type="string" data-required="false" data-desc="指定一个目标语言。此标志可多次使用以包含多种语言（例如，--langs zh --langs ja）。"></x-field>
-  <x-field data-name="--docs" data-type="string" data-required="false" data-desc="指定要翻译的文档路径。此标志也可多次使用以进行批量翻译。"></x-field>
+  <x-field data-name="--langs" data-type="string" data-required="false" data-desc="指定一个目标语言。此标志可以多次使用以包含多种语言（例如，--langs zh --langs ja）。"></x-field>
+  <x-field data-name="--docs" data-type="string" data-required="false" data-desc="指定要翻译的文档路径。此标志也可以多次使用以进行批量翻译。"></x-field>
   <x-field data-name="--feedback" data-type="string" data-required="false" data-desc="向 AI 提供建议以指导翻译质量（例如，--feedback &quot;使用正式语气&quot;）。"></x-field>
-  <x-field data-name="--glossary" data-type="string" data-required="false" data-desc="使用 Markdown 格式的术语表文件，以确保特定术语的一致性（例如，--glossary @path/to/glossary.md）。"></x-field>
+  <x-field data-name="--glossary" data-type="string" data-required="false" data-desc="使用 Markdown 格式的术语表文件，以确保特定术语的用词一致（例如，--glossary @path/to/glossary.md）。"></x-field>
+  <x-field data-name="--model" data-type="string" data-required="false" data-desc="指定要使用的翻译模型，例如 'openai:gpt-4o' 或 'google:gemini-2.5-pro'。"></x-field>
 </x-field-group>
 
 ### 示例
 
 #### 翻译特定文档
 
-要将 `overview.md` 和 `examples.md` 翻译成中文和日文，请运行：
+要将 `overview.md` 和 `examples.md` 翻译成中文和日文，请运行以下命令：
 
 ```bash
 aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
@@ -47,12 +48,20 @@ aigne doc translate --langs zh --langs ja --docs overview.md --docs examples.md
 
 #### 使用术语表和反馈
 
-为确保品牌名称和技术术语翻译正确，您可以提供一个术语表文件。您还可以提供反馈来优化翻译风格。
+为确保品牌名称和技术术语翻译正确，您可以提供一个术语表文件。您还可以提供反馈以改进翻译风格。
 
 ```bash
 aigne doc translate --glossary @path/to/glossary.md --feedback "Use technical terminology consistently" --docs overview.md --langs de
 ```
 
+#### 指定翻译模型
+
+要使用特定的 AI 模型执行翻译任务，请使用 `--model` 标志。
+
+```bash
+aigne doc translate --docs overview.md --langs fr --model openai:gpt-4o
+```
+
 ## 支持的语言
 
 DocSmith 支持以下 12 种语言的自动翻译：
@@ -74,8 +83,8 @@ DocSmith 支持以下 12 种语言的自动翻译：
 
 ---
 
-文档翻译完成后，您就可以与世界分享了。
+文档翻译完成后，您就可以与全世界分享了。
 
 <x-card data-title="下一步：发布您的文档" data-icon="lucide:upload-cloud" data-href="/features/publish-your-docs" data-cta="阅读更多">
-  关于如何将您的文档发布到公共平台或您自己的私有网站的指南。
+  一份关于如何轻松将您的文档发布到公共平台或您自己的私人网站的指南。
 </x-card>

package/docs/features-update-and-refine.ja.md

@@ -1,192 +1,142 @@
-# 更新とリファイン
+# 更新と改良
 
-進化するコードベースとドキュメントを同期させることは、体系的なプロセスです。AIGNE DocSmithは、コードの変更に基づく自動更新、またはフィードバックに基づいた正確なリファインによって、コンテンツを最新の状態に保つための直接的で柔軟なコマンドを提供します。
+進化するコードベースとドキュメントを同期させることは、系統的なプロセスです。AIGNE DocSmith は、コードの変更に基づく自動更新、またはフィードバックに基づいた正確な改良を通じて、コンテンツを最新の状態に保つための直接的で柔軟なコマンドを提供します。
 
-このガイドでは、以下の手順について説明します。
+このガイドでは、以下のタスクの手順を説明します。
 
-- ソースコードが変更されたときにドキュメントを自動的に更新する。
-- 対象を絞ったフィードバックを使用して特定のドキュメントを再生成する。
-- ドキュメント全体の構造を調整する。
+*   ソースコードが変更されたときにドキュメントを自動的に更新する。
+*   ターゲットを絞ったフィードバックを使用して特定のドキュメントを再生成する。
+*   ドキュメント全体の構造を調整する。
 
 ### ドキュメント更新ワークフロー
 
-以下の図は、ドキュメントを更新するために利用できるさまざまなワークフローを示しています。
+以下の図は、ドキュメントを更新するために利用可能なさまざまなワークフローを示しています。
 
 ```d2 ドキュメント更新ワークフロー
 direction: down
 
-developer: {
+Developer: {
   shape: c4-person
-  label: "開発者"
 }
 
-codebase: {
-  shape: cylinder
+Source-Code: {
   label: "ソースコード"
 }
 
-updated-documentation: {
-  shape: cylinder
-  label: "更新された\nドキュメント"
+Documentation: {
+  label: "ドキュメント"
 }
 
-workflows: {
-  label: "ドキュメント更新ワークフロー"
+Action-Choice: {
+  label: "アクションを選択"
+  shape: diamond
+}
+
+Generate-Sync: {
+  label: "aigne doc generate"
   shape: rectangle
 
-  automatic-updates: {
-    label: "自動更新 (コード駆動)"
-    shape: rectangle
+  Change-Detection: {
+    label: "変更を検出？"
+    shape: diamond
+  }
+  Regenerate-Affected: "影響を受けるものを再生成"
+  Regenerate-All: "すべてを再生成"
 
-    cmd-generate: {
-      label: "aigne doc generate"
-    }
+  Change-Detection -> Regenerate-Affected: "はい (デフォルト)"
+  Change-Detection -> Regenerate-All: "いいえ\n(--forceRegenerate)"
+}
 
-    decision-force: {
-      label: "--forceRegenerate?"
-      shape: diamond
-    }
+Refine-Content: {
+  label: "aigne doc update"
+}
 
-    detect-changes: {
-      label: "変更を検出"
-    }
+Refine-Structure: {
+  label: "aigne doc generate\n--feedback"
+}
 
-    regen-affected: {
-      label: "影響を受ける\nドキュメントを再生成"
-    }
+Developer -> Action-Choice
 
-    regen-all: {
-      label: "すべての\nドキュメントを再生成"
-    }
-  }
+Action-Choice -> Generate-Sync: "コードと同期"
+Action-Choice -> Refine-Content: "ドキュメント内容を改良"
+Action-Choice -> Refine-Structure: "ドキュメント構造を改良"
 
-  manual-refinements: {
-    label: "手動リファイン (フィードバック駆動)"
-    shape: rectangle
-    grid-columns: 2
-    grid-gap: 100
-
-    refine-individual: {
-      label: "個別ドキュメントのリファイン"
-      shape: rectangle
-
-      cmd-update: {
-        label: "aigne doc update\n--feedback"
-      }
-
-      regen-specific: {
-        label: "特定の\nドキュメントを再生成"
-      }
-    }
-
-    optimize-structure: {
-      label: "全体構造の最適化"
-      shape: rectangle
-
-      cmd-generate-feedback: {
-        label: "aigne doc generate\n--feedback"
-      }
-
-      re-evaluate-plan: {
-        label: "ドキュメント計画\nの再評価"
-      }
-    }
-  }
-}
+Source-Code -> Generate-Sync
 
-# --- 接続 ---
-
-# パス1: 自動更新
-developer -> codebase: "1. 変更を加える"
-codebase -> workflows.automatic-updates.cmd-generate: "2. コマンドを実行"
-workflows.automatic-updates.cmd-generate -> workflows.automatic-updates.decision-force
-workflows.automatic-updates.decision-force -> workflows.automatic-updates.detect-changes: "いいえ"
-workflows.automatic-updates.detect-changes -> workflows.automatic-updates.regen-affected
-workflows.automatic-updates.decision-force -> workflows.automatic-updates.regen-all: "はい"
-workflows.automatic-updates.regen-affected -> updated-documentation
-workflows.automatic-updates.regen-all -> updated-documentation
-
-# パス2: 個別リファイン
-developer -> workflows.manual-refinements.refine-individual.cmd-update: "3. コンテンツの\nフィードバックを提供"
-workflows.manual-refinements.refine-individual.cmd-update -> workflows.manual-refinements.refine-individual.regen-specific
-workflows.manual-refinements.refine-individual.regen-specific -> updated-documentation
-
-# パス3: 構造リファイン
-developer -> workflows.manual-refinements.optimize-structure.cmd-generate-feedback: "4. 構造に関する\nフィードバックを提供"
-workflows.manual-refinements.optimize-structure.cmd-generate-feedback -> workflows.manual-refinements.optimize-structure.re-evaluate-plan
-workflows.manual-refinements.optimize-structure.re-evaluate-plan -> updated-documentation: "新しい構造で\n再生成"
+Generate-Sync.Regenerate-Affected -> Documentation: "更新"
+Generate-Sync.Regenerate-All -> Documentation: "更新"
+Refine-Content -> Documentation: "更新"
+Refine-Structure -> Documentation: "更新"
 ```
 
 ---
 
 ## 変更検出による自動更新
 
-`aigne doc generate`コマンドを実行すると、DocSmithはまずコードベースを分析して、前回の生成以降の変更を検出します。その後、これらの変更によって影響を受けるドキュメントのみを再生成します。このデフォルトの動作により、時間が節約され、APIの使用量が削減されます。
+`aigne doc generate` コマンドを実行すると、DocSmith はまずコードベースを分析して、最後の生成以降の変更を検出します。次に、これらの変更によって影響を受けるドキュメントのみを再生成します。このデフォルトの動作により、冗長な操作を回避することで、時間を節約し、API の使用量を削減します。
 
 ```shell icon=lucide:terminal
-# DocSmithは変更を検出し、必要なものだけを更新します
+# DocSmith が変更を検出し、必要なものだけを更新します
 aigne doc generate
 ```
 
-![DocSmithが変更を検出し、必要なドキュメントのみを再生成します。](https://docsmith.aigne.io/image-bin/uploads/21a76b2f65d14d16a49c13d800f1e2c1.png)
+![DocSmith は変更を検出し、必要なドキュメントのみを再生成します。](../assets/screenshots/doc-regenerate.png)
 
 ### 完全な再生成の強制
 
-キャッシュと変更検出をバイパスして、すべてのドキュメントをゼロから再生成するには、`--forceRegenerate`フラグを使用します。これは、大幅な設定変更を行った場合や、一貫性を確保するために完全な再構築が必要な場合に必要です。
+キャッシュと変更検出をバイパスして、すべてのドキュメントを最初から再生成するには、`--forceRegenerate` フラグを使用します。これは、大幅な設定変更を行った場合や、すべてのファイルで一貫性を確保するために完全な再構築が必要な場合に必要です。
 
 ```shell icon=lucide:terminal
-# すべてのドキュメントをゼロから再生成します
+# すべてのドキュメントをゼロから再生成する
 aigne doc generate --forceRegenerate
 ```
 
 ---
 
-## 個別ドキュメントのリファイン
+## フィードバックによるドキュメントの改良
+
+対応するコードの変更なしに、CLI コマンドに直接フィードバックを提供することでドキュメントを改良できます。これは、明確さを向上させたり、例を追加したり、構造を調整したりするのに役立ちます。
 
-対応するコードの変更なしに特定のドキュメントのコンテンツを改善するには、`aigne doc update`コマンドを使用します。このコマンドを使用すると、リファインのための具体的な指示を提供できます。
+### 個別ドキュメント内容の改良
 
-これは、対話形式またはコマンドライン引数を使用して非対話形式で行うことができます。
+特定のドキュメントの内容を改善するには、`aigne doc update` コマンドを使用します。このコマンドを使用すると、改良のための具体的な指示を提供でき、インタラクティブモードと非インタラクティブモードの2つのモードで実行できます。
 
-### 対話モード
+#### インタラクティブモード
 
-ガイド付きのプロセスを行うには、引数なしでコマンドを実行します。DocSmithは、更新したいドキュメントを選択するためのメニューを表示します。選択後、フィードバックを入力するよう求められます。
+ガイド付きのプロセスについては、引数なしでコマンドを実行します。DocSmith は、更新したいドキュメントを選択するためのメニューを表示します。選択後、フィードバックを入力するよう求められます。
 
 ```shell icon=lucide:terminal
-# 対話的な更新プロセスを開始します
+# インタラクティブな更新プロセスを開始する
 aigne doc update
 ```
 
-![更新したいドキュメントを対話形式で選択します。](https://docsmith.aigne.io/image-bin/uploads/75e9cf9823bb369c3d2b5a2e2da4ac06.png)
+![更新したいドキュメントをインタラクティブに選択します。](../assets/screenshots/doc-update.png)
 
-### 直接的なコマンドライン更新
+#### 非インタラクティブモード
 
-スクリプト化された、またはより高速なワークフローのために、フラグを使用してドキュメントとフィードバックを直接指定できます。これにより、正確な非対話形式の更新が可能になります。
+スクリプト化された、またはより高速なワークフローの場合、フラグを使用してドキュメントとフィードバックを直接指定できます。これにより、正確な非インタラクティブな更新が可能になります。
 
 ```shell icon=lucide:terminal
-# フィードバック付きで特定のドキュメントを更新します
-aigne doc update --docs overview.md --feedback "最後に詳細なFAQセクションを追加してください。"
+# 特定のドキュメントをフィードバックで更新する
+aigne doc update --docs overview.md --feedback "最後に、より詳細な FAQ セクションを追加してください。"
 ```
 
-`update`コマンドの主要なパラメータは以下の通りです。
+`update` コマンドの主要なパラメータは次のとおりです。
 
 | パラメータ | 説明 |
-| --- | --- |
+| :--- | :--- |
 | `--docs` | 更新するドキュメントへのパス。このフラグはバッチ更新のために複数回使用できます。 |
-| `--feedback` | コンテンツを再生成する際に使用される具体的な指示。 |
-
----
-
-## 全体構造の最適化
+| `--feedback` | ドキュメントのコンテンツを再生成する際に使用される具体的な指示を含む文字列。 |
 
-個々のドキュメントのコンテンツをリファインすることに加えて、ドキュメント全体の構造を調整することもできます。既存の構成が最適でない場合やセクションが欠落している場合は、`generate`コマンドにフィードバックを提供できます。
+### 全体構造の最適化
 
-これにより、DocSmithは入力に基づいてドキュメント計画全体を再評価するように指示されます。
+個々のドキュメントの改良に加えて、ドキュメント全体の構造を調整することもできます。既存の構成が最適でない場合やセクションが欠落している場合は、`generate` コマンドにフィードバックを提供できます。これにより、DocSmith はあなたの入力に基づいてドキュメントプラン全体を再評価するよう指示されます。
 
 ```shell icon=lucide:terminal
-# 特定のフィードバックでドキュメント構造を再生成します
+# 特定のフィードバックでドキュメント構造を再生成する
 aigne doc generate --feedback "'概要'セクションを削除し、詳細な'APIリファレンス'を追加してください。"
 ```
 
-このアプローチは、ドキュメントの目次に対する高レベルの変更を目的としており、軽微なコンテンツの編集を目的としたものではありません。
+このアプローチは、単一ファイル内のマイナーなコンテンツ編集ではなく、ドキュメントの目次に対する高レベルの変更を目的としています。
 
-コンテンツがリファインされたら、次のステップはグローバルなオーディエンス向けに準備することです。手順については、[ドキュメントの翻訳](./features-translate-documentation.md)ガイドを参照してください。
+コンテンツが改良されたら、次のステップはそれを世界中の読者に向けて準備することです。手順については、[ドキュメントの翻訳](./features-translate-documentation.md)ガイドを参照してください。