@aigne/doc-smith 0.8.11-beta.5 → 0.8.11-beta.7

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

@@ -1,138 +1,142 @@
 # 更新と改良
 
-進化するコードベースとドキュメントを同期させることは、重要なタスクです。AIGNE DocSmithは、コードの変更に基づく自動更新や、フィードバックに基づいた正確な改良を通じて、コンテンツを最新の状態に保つための直接的で柔軟な方法を提供します。
+進化するコードベースとドキュメントを同期させることは、系統的なプロセスです。AIGNE DocSmith は、コードの変更に基づく自動更新、またはフィードバックに基づいた正確な改良を通じて、コンテンツを最新の状態に保つための直接的で柔軟なコマンドを提供します。
 
-このガイドでは、以下の方法について説明します：
+このガイドでは、以下のタスクの手順を説明します。
 
-- ソースコードが変更されたときにドキュメントを自動的に更新する。
-- 特定のフィードバックを使用して特定のドキュメントを再生成する。
-- ドキュメント全体の構造を調整する。
+*   ソースコードが変更されたときにドキュメントを自動的に更新する。
+*   ターゲットを絞ったフィードバックを使用して特定のドキュメントを再生成する。
+*   ドキュメント全体の構造を調整する。
 
-### ドキュメント更新のワークフロー
+### ドキュメント更新ワークフロー
 
-以下の図は、ドキュメントを更新するために利用できるさまざまなパスを示しています：
+以下の図は、ドキュメントを更新するために利用可能なさまざまなワークフローを示しています。
 
-```d2 更新ワークフロー
+```d2 ドキュメント更新ワークフロー
 direction: down
 
-Start: {
-  shape: circle
-  label: "開始"
+Developer: {
+  shape: c4-person
 }
 
-Code-Change: {
-  label: "ソースコードまたは\n設定の変更"
-  shape: rectangle
+Source-Code: {
+  label: "ソースコード"
 }
 
-Content-Tweak: {
-  label: "コンテンツの\n改善が必要か？"
-  shape: rectangle
+Documentation: {
+  label: "ドキュメント"
 }
 
-Structure-Tweak: {
-  label: "構造の\n改善が必要か？"
-  shape: rectangle
+Action-Choice: {
+  label: "アクションを選択"
+  shape: diamond
 }
 
-Start -> Code-Change
-Start -> Content-Tweak
-Start -> Structure-Tweak
+Generate-Sync: {
+  label: "aigne doc generate"
+  shape: rectangle
 
-Code-Change -> Generate-Command: "aigne doc generate"
+  Change-Detection: {
+    label: "変更を検出？"
+    shape: diamond
+  }
+  Regenerate-Affected: "影響を受けるものを再生成"
+  Regenerate-All: "すべてを再生成"
 
-Generate-Command -> Change-Detection: {
-  label: "変更検出"
-  shape: diamond
+  Change-Detection -> Regenerate-Affected: "はい (デフォルト)"
+  Change-Detection -> Regenerate-All: "いいえ\n(--forceRegenerate)"
 }
-Change-Detection -> Auto-Regen: "影響を受ける\nドキュメントを再生成"
 
-Content-Tweak -> Update-Command: "aigne doc update\n--feedback"
-Update-Command -> Manual-Regen: "特定の\nドキュメントを再生成"
-
-Structure-Tweak -> Generate-Feedback-Command: "aigne doc generate\n--feedback"
-Generate-Feedback-Command -> Replan: "ドキュメント構造を\n再計画"
+Refine-Content: {
+  label: "aigne doc update"
+}
 
-End: {
-  shape: circle
-  label: "ドキュメント更新済み"
+Refine-Structure: {
+  label: "aigne doc generate\n--feedback"
 }
 
-Auto-Regen -> End
-Manual-Regen -> End
-Replan -> End
+Developer -> Action-Choice
+
+Action-Choice -> Generate-Sync: "コードと同期"
+Action-Choice -> Refine-Content: "ドキュメント内容を改良"
+Action-Choice -> Refine-Structure: "ドキュメント構造を改良"
+
+Source-Code -> Generate-Sync
+
+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` コマンドを使用すると、コンテンツの改良に関する的を絞った指示を提供できます。
+### 個別ドキュメント内容の改良
 
-このコマンドは、対話形式またはコマンドライン引数を介して直接、2つの方法で使用できます。
+特定のドキュメントの内容を改善するには、`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 "Add a more detailed FAQ section at the end."
+# 特定のドキュメントをフィードバックで更新する
+aigne doc update --docs overview.md --feedback "最後に、より詳細な FAQ セクションを追加してください。"
 ```
 
-`update` コマンドの主要なパラメータ：
-
-| パラメータ  | 説明                                                                                      |
-| ---------- | ------------------------------------------------------------------------------------------------ |
-| `--docs`     | 更新したいドキュメントへのパス。バッチ更新のためにこのフラグを複数回使用できます。 |
-| `--feedback` | コンテンツを再生成する際に使用する具体的な指示。                       |
-
----
+`update` コマンドの主要なパラメータは次のとおりです。
 
-## 全体構造の最適化
+| パラメータ | 説明 |
+| :--- | :--- |
+| `--docs` | 更新するドキュメントへのパス。このフラグはバッチ更新のために複数回使用できます。 |
+| `--feedback` | ドキュメントのコンテンツを再生成する際に使用される具体的な指示を含む文字列。 |
 
-個々のドキュメントのコンテンツを改良するだけでなく、ドキュメント全体の構造も調整できます。セクションが欠けている場合や、既存の構成を改善できる場合は、`generate` コマンドにフィードバックを提供できます。
+### 全体構造の最適化
 
-このコマンドは、DocSmithに新しい入力に基づいてドキュメントプラン全体を再評価するよう指示します。
+個々のドキュメントの改良に加えて、ドキュメント全体の構造を調整することもできます。既存の構成が最適でない場合やセクションが欠落している場合は、`generate` コマンドにフィードバックを提供できます。これにより、DocSmith はあなたの入力に基づいてドキュメントプラン全体を再評価するよう指示されます。
 
 ```shell icon=lucide:terminal
-# 特定のフィードバックを付けてドキュメント構造を再生成します
-aigne doc generate --feedback "Remove the 'About' section and add a detailed 'API Reference'."
+# 特定のフィードバックでドキュメント構造を再生成する
+aigne doc generate --feedback "'概要'セクションを削除し、詳細な'APIリファレンス'を追加してください。"
 ```
 
-このアプローチは、行単位のコンテンツ編集ではなく、ドキュメントの目次に対する高レベルの変更に最適です。
+このアプローチは、単一ファイル内のマイナーなコンテンツ編集ではなく、ドキュメントの目次に対する高レベルの変更を目的としています。
 
-これらのツールを使用すると、プロジェクトと共に進化する正確なドキュメントを維持できます。コンテンツが改良されたら、世界中のオーディエンスに公開できます。その方法については、[ドキュメントの翻訳](./features-translate-documentation.md)ガイドで学んでください。
+コンテンツが改良されたら、次のステップはそれを世界中の読者に向けて準備することです。手順については、[ドキュメントの翻訳](./features-translate-documentation.md)ガイドを参照してください。

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

@@ -1,84 +1,90 @@
 # Update and Refine
 
-Keeping documentation synchronized with an evolving codebase is a critical task. AIGNE DocSmith provides direct and flexible methods to keep your content current, whether through automatic updates based on code changes or precise, feedback-driven refinements.
+Keeping documentation synchronized with an evolving codebase is a methodical process. AIGNE DocSmith provides direct and flexible commands to keep your content current, either through automatic updates based on code changes or through precise, feedback-driven refinements.
 
-This guide covers how to:
+This guide provides procedures for the following tasks:
 
-- Automatically update documents when your source code changes.
-- Regenerate specific documents using targeted feedback.
-- Adjust the overall documentation structure.
+*   Automatically updating documents when source code is modified.
+*   Regenerating specific documents using targeted feedback.
+*   Adjusting the overall documentation structure.
 
 ### Document Update Workflows
 
-The following diagram illustrates the different paths you can take to update your documentation:
+The following diagram illustrates the different workflows available for updating your documentation:
 
-```d2 Update Workflows
+```d2 Document Update Workflows
 direction: down
 
-Start: {
-  shape: circle
-  label: "Start"
+Developer: {
+  shape: c4-person
 }
 
-Code-Change: {
-  label: "Source Code or\nConfig Changes"
-  shape: rectangle
+Source-Code: {
+  label: "Source Code"
 }
 
-Content-Tweak: {
-  label: "Need Content\nImprovement?"
-  shape: rectangle
+Documentation: {
+  label: "Documentation"
 }
 
-Structure-Tweak: {
-  label: "Need Structure\nImprovement?"
-  shape: rectangle
+Action-Choice: {
+  label: "Choose Action"
+  shape: diamond
 }
 
-Start -> Code-Change
-Start -> Content-Tweak
-Start -> Structure-Tweak
+Generate-Sync: {
+  label: "aigne doc generate"
+  shape: rectangle
 
-Code-Change -> Generate-Command: "aigne doc generate"
+  Change-Detection: {
+    label: "Detect Changes?"
+    shape: diamond
+  }
+  Regenerate-Affected: "Regenerate Affected"
+  Regenerate-All: "Regenerate All"
 
-Generate-Command -> Change-Detection: {
-  label: "Change Detection"
-  shape: diamond
+  Change-Detection -> Regenerate-Affected: "Yes (Default)"
+  Change-Detection -> Regenerate-All: "No\n(--forceRegenerate)"
 }
-Change-Detection -> Auto-Regen: "Regenerates\nAffected Docs"
 
-Content-Tweak -> Update-Command: "aigne doc update\n--feedback"
-Update-Command -> Manual-Regen: "Regenerates\nSpecific Doc"
-
-Structure-Tweak -> Generate-Feedback-Command: "aigne doc generate\n--feedback"
-Generate-Feedback-Command -> Replan: "Re-plans Document\nStructure"
+Refine-Content: {
+  label: "aigne doc update"
+}
 
-End: {
-  shape: circle
-  label: "Docs Updated"
+Refine-Structure: {
+  label: "aigne doc generate\n--feedback"
 }
 
-Auto-Regen -> End
-Manual-Regen -> End
-Replan -> End
+Developer -> Action-Choice
+
+Action-Choice -> Generate-Sync: "Sync with Code"
+Action-Choice -> Refine-Content: "Refine Doc Content"
+Action-Choice -> Refine-Structure: "Refine Doc Structure"
+
+Source-Code -> Generate-Sync
+
+Generate-Sync.Regenerate-Affected -> Documentation: "Update"
+Generate-Sync.Regenerate-All -> Documentation: "Update"
+Refine-Content -> Documentation: "Update"
+Refine-Structure -> Documentation: "Update"
 ```
 
 ---
 
 ## Automatic Updates with Change Detection
 
-When you run the `aigne doc generate` command, DocSmith analyzes your codebase, detects any changes since the last run, and regenerates only the documents that are affected. This process saves time and reduces unnecessary API calls.
+When you execute the `aigne doc generate` command, DocSmith first analyzes your codebase to detect changes since the last generation. It then regenerates only the documents affected by these changes. This default behavior conserves time and reduces API usage by avoiding redundant operations.
 
 ```shell icon=lucide:terminal
-# DocSmith will detect changes and update only what's necessary
+# DocSmith will detect changes and update only what is necessary
 aigne doc generate
 ```
 
-![DocSmith detects changes and regenerates only the required documents.](https://docsmith.aigne.io/image-bin/uploads/21a76b2f65d14d16a49c13d800f1e2c1.png)
+![DocSmith detects changes and regenerates only the required documents.](../assets/screenshots/doc-regenerate.png)
 
 ### Forcing a Full Regeneration
 
-If you need to regenerate all documentation from scratch, ignoring any cached or previous state, use the `--forceRegenerate` flag. This is useful after significant configuration changes or when you want to ensure a completely fresh build.
+To regenerate all documentation from scratch, bypassing the cache and change detection, use the `--forceRegenerate` flag. This is necessary when you have made significant configuration changes or require a complete rebuild to ensure consistency across all files.
 
 ```shell icon=lucide:terminal
 # Regenerate all documentation from the ground up
@@ -87,52 +93,50 @@ aigne doc generate --forceRegenerate
 
 ---
 
-## Refining Individual Documents
+## Refining Documents with Feedback
+
+You can refine documentation without corresponding code changes by providing direct feedback to the CLI commands. This is useful for improving clarity, adding examples, or adjusting the structure.
 
-To improve a specific document without any corresponding code changes, the `aigne doc update` command allows you to provide targeted instructions for content refinement.
+### Refining Individual Document Content
 
-You can use this command in two ways: interactively or directly via command-line arguments.
+To improve a specific document's content, use the `aigne doc update` command. This command allows you to provide targeted instructions for refinement and can be run in two modes: interactive or non-interactive.
 
-### Interactive Mode
+#### Interactive Mode
 
-For a guided experience, run the command without any arguments. DocSmith will present a menu to select which document you want to update. After you choose, you'll be prompted to enter your feedback.
+For a guided process, run the command without arguments. DocSmith will present a menu to select the document you wish to update. After selection, you will be prompted to enter your feedback.
 
 ```shell icon=lucide:terminal
 # Start the interactive update process
 aigne doc update
 ```
 
-![Interactively select the documents you wish to update.](https://docsmith.aigne.io/image-bin/uploads/75e9cf9823bb369c3d2b5a2e2da4ac06.png)
+![Interactively select the documents you wish to update.](../assets/screenshots/doc-update.png)
 
-### Direct Command-Line Updates
+#### Non-Interactive Mode
 
-For faster workflows or scripting, you can specify the document and feedback directly using flags. This allows for precise, non-interactive updates.
+For scripted or faster workflows, you can specify the document and feedback directly using flags. This enables precise, non-interactive updates.
 
 ```shell icon=lucide:terminal
 # Update a specific document with feedback
 aigne doc update --docs overview.md --feedback "Add a more detailed FAQ section at the end."
 ```
 
-Key parameters for the `update` command:
-
-| Parameter  | Description                                                                                      |
-| ---------- | ------------------------------------------------------------------------------------------------ |
-| `--docs`     | The path to the document you want to update. You can use this flag multiple times for batch updates. |
-| `--feedback` | The specific instructions to use when regenerating the content.                       |
-
----
+The primary parameters for the `update` command are as follows:
 
-## Optimizing the Overall Structure
+| Parameter | Description |
+| :--- | :--- |
+| `--docs` | The path to the document to be updated. This flag can be used multiple times for batch updates. |
+| `--feedback` | A string containing the specific instructions to be used when regenerating the document's content. |
 
-Beyond refining the content of individual documents, you can also adjust the overall documentation structure. If a section is missing or the existing organization could be improved, you can provide feedback to the `generate` command.
+### Optimizing the Overall Structure
 
-This command instructs DocSmith to re-evaluate the entire document plan based on your new input.
+In addition to refining individual documents, you can adjust the overall documentation structure. If the existing organization is suboptimal or a section is missing, you can provide feedback to the `generate` command. This instructs DocSmith to re-evaluate the entire document plan based on your input.
 
 ```shell icon=lucide:terminal
 # Regenerate the documentation structure with specific feedback
 aigne doc generate --feedback "Remove the 'About' section and add a detailed 'API Reference'."
 ```
 
-This approach is best for high-level changes to the document's table of contents, rather than line-by-line content edits.
+This approach is intended for high-level changes to the document's table of contents, not for minor content edits within a single file.
 
-With these tools, you can maintain accurate documentation that evolves alongside your project. Once your content is refined, you can make it available to a global audience. Learn how in the [Translate Documentation](./features-translate-documentation.md) guide.
+Once your content is refined, the next step is to prepare it for a global audience. For instructions, see the [Translate Documentation](./features-translate-documentation.md) guide.

package/docs/features-update-and-refine.zh-TW.md

@@ -1,138 +1,143 @@
-# 更新與優化
+# 更新與完善
 
-讓文件與不斷演進的程式碼庫保持同步是一項關鍵任務。AIGNE DocSmith 提供了直接且靈活的方法來讓您的內容保持最新，無論是透過基於程式碼變更的自動更新，還是透過精確、由回饋意見驅動的優化。
+讓文件與不斷演進的程式碼庫保持同步是一項有條不紊的過程。AIGNE DocSmith 提供直接而靈活的指令，讓您能透過程式碼變更自動更新，或透過精確、由回饋驅動的完善方式，來保持內容的最新狀態。
 
-本指南涵蓋如何：
+本指南提供執行以下任務的程序：
 
-- 在您的原始碼變更時自動更新文件。
-- 使用針對性的回饋意見重新生成特定文件。
-- 調整整體文件結構。
+*   在原始碼修改時自動更新文件。
+*   使用針對性的回饋重新產生特定文件。
+*   調整整體文件結構。
 
 ### 文件更新工作流程
 
-下圖說明了更新文件的不同路徑：
+下圖說明了更新文件可用的不同工作流程：
 
-```d2 更新工作流程
+```d2 文件更新工作流程
 direction: down
 
-Start: {
-  shape: circle
-  label: "開始"
+Developer: {
+  shape: c4-person
+  label: "開發者"
 }
 
-Code-Change: {
-  label: "原始碼或\n設定檔變更"
-  shape: rectangle
+Source-Code: {
+  label: "原始碼"
 }
 
-Content-Tweak: {
-  label: "需要內容\n改善？"
-  shape: rectangle
+Documentation: {
+  label: "文件"
 }
 
-Structure-Tweak: {
-  label: "需要結構\n改善？"
-  shape: rectangle
+Action-Choice: {
+  label: "選擇操作"
+  shape: diamond
 }
 
-Start -> Code-Change
-Start -> Content-Tweak
-Start -> Structure-Tweak
+Generate-Sync: {
+  label: "aigne doc generate"
+  shape: rectangle
 
-Code-Change -> Generate-Command: "aigne doc generate"
+  Change-Detection: {
+    label: "偵測變更？"
+    shape: diamond
+  }
+  Regenerate-Affected: "重新產生受影響部分"
+  Regenerate-All: "全部重新產生"
 
-Generate-Command -> Change-Detection: {
-  label: "變更偵測"
-  shape: diamond
+  Change-Detection -> Regenerate-Affected: "是 (預設)"
+  Change-Detection -> Regenerate-All: "否\n(--forceRegenerate)"
 }
-Change-Detection -> Auto-Regen: "重新生成\n受影響文件"
 
-Content-Tweak -> Update-Command: "aigne doc update\n--feedback"
-Update-Command -> Manual-Regen: "重新生成\n特定文件"
-
-Structure-Tweak -> Generate-Feedback-Command: "aigne doc generate\n--feedback"
-Generate-Feedback-Command -> Replan: "重新規劃文件\n結構"
+Refine-Content: {
+  label: "aigne doc update"
+}
 
-End: {
-  shape: circle
-  label: "文件已更新"
+Refine-Structure: {
+  label: "aigne doc generate\n--feedback"
 }
 
-Auto-Regen -> End
-Manual-Regen -> End
-Replan -> End
+Developer -> Action-Choice
+
+Action-Choice -> Generate-Sync: "與程式碼同步"
+Action-Choice -> Refine-Content: "完善文件內容"
+Action-Choice -> Refine-Structure: "完善文件結構"
+
+Source-Code -> Generate-Sync
+
+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` 指令。此指令允許您提供針對性的完善指示，並可以互動或非互動兩種模式執行。
 
-### 互動模式
+#### 互動模式
 
-若要獲得引導式體驗，請在不帶任何參數的情況下執行此命令。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 "Add a more detailed FAQ section at the end."
 ```
 
-`update` 命令的主要參數：
+`update` 指令的主要參數如下：
 
 | 參數 | 說明 |
-| ---------- | ------------------------------------------------------------------------------------------------ |
-| `--docs` | 您想更新的文件的路徑。您可以多次使用此標記進行批次更新。 |
-| `--feedback` | 重新生成內容時要使用的具體指示。 |
-
----
-
-## 優化整體結構
+| :--- | :--- |
+| `--docs` | 要更新的文件的路徑。此旗標可多次使用以進行批次更新。 |
+| `--feedback` | 一個字串，包含重新產生文件內容時要使用的具體指示。 |
 
-除了優化單一文件的內容，您還可以調整整體的文件結構。如果某個部分缺失或現有組織可以改進，您可以向 `generate` 命令提供回饋意見。
+### 最佳化整體結構
 
-此命令指示 DocSmith 根據您的新輸入重新評估整個文件計畫。
+除了完善個別文件外，您還可以調整整體文件結構。如果現有組織結構不佳或缺少某個部分，您可以向 `generate` 指令提供回饋。這會指示 DocSmith 根據您的輸入重新評估整個文件計畫。
 
 ```shell icon=lucide:terminal
-# 帶有特定回饋意見以重新生成文件結構
+# 透過特定回饋重新產生文件結構
 aigne doc generate --feedback "Remove the 'About' section and add a detailed 'API Reference'."
 ```
 
-這種方法最適合對文件的目錄進行高層次的變更，而非逐行的內容編輯。
+此方法適用於對文件目錄進行高層次的變更，而非針對單一檔案內的微小內容編輯。
 
-有了這些工具，您可以維護與您的專案一同演進的準確文件。一旦您的內容被優化，您就可以將其提供給全球的受眾。請在[翻譯文件](./features-translate-documentation.md)指南中了解如何操作。
+內容完善後，下一步是為全球受眾做準備。相關說明，請參閱 [翻譯文件](./features-translate-documentation.md) 指南。