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

package/docs/configuration.ja.md

@@ -1,22 +1,62 @@
 # 設定ガイド
 
-AIGNE DocSmithの動作は、`.aigne/doc-smith/config.yaml`に配置されている中央ファイル、`config.yaml`によって制御されます。このファイルは、ドキュメントのスタイル、対象読者、言語、構造を決定します。
+AIGNE DocSmith の動作は、中央設定ファイル `.aigne/doc-smith/config.yaml` によって制御されます。このファイルを使用して、ドキュメントのスタイル、対象読者、言語、構造を特定のニーズに合わせてカスタマイズできます。
 
-`aigne doc init`を実行することで、対話式セットアップウィザードを使用してこのファイルを作成および管理できます。ステップバイステップのウォークスルーについては、[対話式セットアップ](./configuration-interactive-setup.md)ガイドを参照してください。
+`aigne doc init` を実行して、対話式のセットアップウィザードを使用してこのファイルを作成および管理できます。手順ごとのウォークスルーについては、[対話式セットアップ](./configuration-interactive-setup.md)ガイドを参照してください。または、ファイルを直接編集して、より詳細な制御を行うこともできます。
 
-## 主要な設定エリア
+以下の図は、設定のワークフローを示しています。
 
-ドキュメントは、いくつかの主要な設定エリアによって形成されます。これらのガイドを参照して、生成プロセスの各側面を微調整する方法を理解してください。
+```d2 設定ワークフロー
+direction: down
+
+User: {
+  shape: person
+}
+
+CLI: {
+  label: "コマンド実行\n'aigne doc init'"
+  shape: rectangle
+}
+
+Setup-Wizard: {
+  label: "対話式セットアップウィザード"
+  shape: rectangle
+}
+
+Config-File: {
+  label: ".aigne/doc-smith/config.yaml"
+  shape: rectangle
+}
+
+AIGNE-DocSmith-Engine: {
+  label: "AIGNE DocSmith エンジン"
+}
+
+# パス1: 対話式セットアップ (推奨)
+User -> CLI: "推奨パス"
+CLI -> Setup-Wizard: "起動"
+Setup-Wizard -> Config-File: "作成 / 変更"
+
+# パス2: 手動編集
+User -> Config-File: "代替パス:\n直接編集"
+
+# 最終ステップ
+Config-File -> AIGNE-DocSmith-Engine: "設定"
+```
+
+## 主要な設定領域
+
+ドキュメントは、いくつかの主要な設定領域によって形成されます。これらのガイドを参照して、生成プロセスの各側面を微調整する方法を理解してください。
 
 <x-cards data-columns="2">
   <x-card data-title="対話式セットアップ" data-icon="lucide:wand-2" data-href="/configuration/interactive-setup">
-    設定の推奨や競合の検出を含む、ドキュメントプロジェクトの設定を支援するガイド付きウィザードについて学びます。
+    推奨設定や競合検出を含む、ドキュメントプロジェクトの設定を支援するガイド付きウィザードについて学びます。
   </x-card>
-  <x-card data-title="LLMセットアップ" data-icon="lucide:brain-circuit" data-href="/configuration/llm-setup">
-    APIキーを必要としない組み込みのAIGNE Hubの使用を含む、さまざまなAIモデルの接続方法を発見します。
+  <x-card data-title="LLM セットアップ" data-icon="lucide:brain-circuit" data-href="/configuration/llm-setup">
+    APIキーが不要な組み込みのAIGNEハブの使用を含む、さまざまなAIモデルの接続方法を発見します。
   </x-card>
   <x-card data-title="言語サポート" data-icon="lucide:languages" data-href="/configuration/language-support">
-    サポートされている言語の完全なリストを確認し、主要言語の設定方法や自動翻訳を有効にする方法を学びます。
+    サポートされている言語の全リストを確認し、主要言語の設定方法や自動翻訳の有効化方法を学びます。
   </x-card>
   <x-card data-title="設定の管理" data-icon="lucide:sliders-horizontal" data-href="/configuration/preferences">
     DocSmithがフィードバックを使用して永続的なルールを作成する方法と、CLIを介してそれらを管理する方法を理解します。
@@ -25,130 +65,130 @@ AIGNE DocSmithの動作は、`.aigne/doc-smith/config.yaml`に配置されてい
 
 ## パラメータリファレンス
 
-`config.yaml`ファイルには、ドキュメントの出力を制御するいくつかのキーと値のペアが含まれています。以下は、各パラメータの詳細なリファレンスです。
+`config.yaml` ファイルには、ドキュメントの出力を制御するいくつかのキーと値のペアが含まれています。以下は、各パラメータの詳細なリファレンスです。
 
 ### プロジェクト情報
 
 これらの設定は、プロジェクトに関する基本的なコンテキストを提供し、ドキュメントを公開する際に使用されます。
 
-| Parameter | Description |
+| パラメータ | 説明 |
 |---|---|
-| `projectName` | プロジェクトの名前。`package.json`が存在する場合、そこから検出されます。 |
-| `projectDesc` | プロジェクトの短い説明。`package.json`から検出されます。 |
-| `projectLogo` | プロジェクトのロゴ画像へのパスまたはURL。 |
+| `projectName` | プロジェクトの名前。`package.json` があればそこから検出されます。 |
+| `projectDesc` | プロジェクトの短い説明。`package.json` から検出されます。 |
+| `projectLogo` | プロジェクトのロゴ画像へのパスまたは URL。 |
 
 ### ドキュメンテーション戦略
 
 これらのパラメータは、生成されるコンテンツのトーン、スタイル、深さを定義します。
 
 #### `documentPurpose`
-読者に達成してほしい主要な成果を定義します。この設定は、ドキュメント全体の構造と焦点に影響を与えます。
+読者に達成してもらいたい主な成果を定義します。この設定は、ドキュメントの全体的な構造と焦点に影響を与えます。
 
-| Option | Name | Description |
+| オプション | 名前 | 説明 |
 |---|---|---|
-| `getStarted` | すぐに始める | 新規ユーザーが30分未満でゼロから作業を開始できるように支援します。 |
+| `getStarted` | 迅速な開始 | 新規ユーザーが30分未満でゼロから作業を開始できるように支援します。 |
 | `completeTasks` | 特定のタスクを完了する | 一般的なワークフローとユースケースを通じてユーザーをガイドします。 |
-| `findAnswers` | 素早く回答を見つける | すべての機能とAPIに対して検索可能なリファレンスを提供します。 |
-| `understandSystem`| システムを理解する | それがどのように機能し、なぜ設計上の決定がなされたのかを説明します。 |
-| `solveProblems` | 一般的な問題をトラブルシューティングする | ユーザーが問題をトラブルシューティングし、修正するのを支援します。 |
+| `findAnswers` | 迅速に答えを見つける | すべての機能とAPIの検索可能なリファレンスを提供します。 |
+| `understandSystem`| システムを理解する | それがどのように機能し、なぜ設計上の決定がなされたかを説明します。 |
+| `solveProblems` | 一般的な問題のトラブルシューティング | ユーザーが問題をトラブルシューティングし、修正するのを助けます。 |
 | `mixedPurpose` | 複数の目的を果たす | 複数のニーズをカバーするドキュメント。 |
 
 #### `targetAudienceTypes`
-このドキュメントを最も頻繁に読む人を定義します。この選択は、ライティングスタイルと例に影響を与えます。
+このドキュメントを最も頻繁に読むであろう人物を定義します。この選択は、ライティングスタイルと例に影響を与えます。
 
-| Option | Name | Description |
+| オプション | 名前 | 説明 |
 |---|---|---|
 | `endUsers` | エンドユーザー（非技術者） | 製品を使用するがコーディングはしない人々。 |
-| `developers` | 製品/APIを統合する開発者 | これを自分たちのプロジェクトに追加するエンジニア。 |
-| `devops` | DevOps / SRE / インフラストラクチャチーム | システムのデプロイ、監視、保守を行うチーム。 |
+| `developers` | 製品/APIを統合する開発者 | これを自分のプロジェクトに追加するエンジニア。 |
+| `devops` | DevOps / SRE / インフラストラクチャチーム | システムの展開、監視、保守を行うチーム。 |
 | `decisionMakers`| 技術的な意思決定者 | 実装を評価または計画するアーキテクトやリード。 |
-| `supportTeams` | サポートチーム | 他者が製品を使用するのを助ける人々。 |
-| `mixedTechnical`| 混合技術者層 | 開発者、DevOps、およびその他の技術ユーザー。 |
+| `supportTeams` | サポートチーム | 他の人が製品を使用するのを助ける人々。 |
+| `mixedTechnical`| 混合技術オーディエンス | 開発者、DevOps、その他の技術ユーザー。 |
 
 #### `readerKnowledgeLevel`
-読者がアクセスした時点で通常知っていることを定義します。これにより、どの程度の基礎知識が前提とされるかが調整されます。
+読者が通常、到着時に何を知っているかを定義します。これにより、どれだけの基礎知識が前提とされるかが調整されます。
 
-| Option | Name | Description |
+| オプション | 名前 | 説明 |
 |---|---|---|
-| `completeBeginners` | 完全な初心者、ゼロから始める | このドメイン/技術に全くの初心者。 |
-| `domainFamiliar` | 以前に類似のツールを使用したことがある | 問題領域は知っているが、この特定のソリューションには新しい。 |
+| `completeBeginners` | 完全な初心者で、ゼロから始める | このドメイン/テクノロジーに全く新しい。 |
+| `domainFamiliar` | 以前に類似のツールを使用したことがある | 問題領域は知っているが、この特定の解決策には新しい。 |
 | `experiencedUsers` | 特定のことをしようとしている専門家 | リファレンスや高度なトピックを必要とする通常のユーザー。 |
 | `emergencyTroubleshooting`| 緊急/トラブルシューティング | 何かが壊れており、迅速に修正する必要がある。 |
-| `exploringEvaluating` | このツールを他と比較して評価している | これが自分たちのニーズに合うかどうかを理解しようとしている。 |
+| `exploringEvaluating` | このツールを他と比較評価している | これが自分のニーズに合うかどうかを理解しようとしている。 |
 
 #### `documentationDepth`
 ドキュメントがどれだけ包括的であるべきかを定義します。
 
-| Option | Name | Description |
+| オプション | 名前 | 説明 |
 |---|---|---|
-| `essentialOnly` | 必須のみ | 80%のユースケースをカバーし、簡潔に保ちます。 |
-| `balancedCoverage`| バランスの取れたカバレッジ | 実践的な例を伴う適切な深さ [推奨]。 |
-| `comprehensive` | 包括的 | すべての機能、エッジケース、および高度なシナリオをカバーします。 |
+| `essentialOnly` | 不可欠なもののみ | 80%のユースケースをカバーし、簡潔に保ちます。 |
+| `balancedCoverage`| バランスの取れたカバレッジ | 実用的な例を含む適切な深さ [推奨]。 |
+| `comprehensive` | 包括的 | すべての機能、エッジケース、高度なシナリオをカバーします。 |
 | `aiDecide` | AIに決定させる | コードの複雑さを分析し、適切な深さを提案します。 |
 
 ### カスタムディレクティブ
 
-より詳細な制御のために、自由記述の指示を提供できます。
+より詳細な制御のために、自由形式の指示を提供できます。
 
-| Parameter | Description |
+| パラメータ | 説明 |
 |---|---|
-| `rules` | 特定のドキュメント生成ルールを定義できる複数行の文字列（例：「常にパフォーマンスベンチマークを含める」）。 |
-| `targetAudience`| プリセットで許可されているよりも詳細に特定の対象読者を記述するための複数行の文字列。 |
+| `rules` | 特定のドキュメント生成ルール（例：「常にパフォーマンスベンチマークを含める」）を定義できる複数行の文字列。 |
+| `targetAudience`| プリセットで許容されるよりも詳細に特定のターゲットオーディエンスを記述するための複数行の文字列。 |
 
 ### 言語とパスの設定
 
-これらの設定は、ローカリゼーションとファイルの場所を制御します。
+これらの設定は、ローカライゼーションとファイルの場所を制御します。
 
-| Parameter | Description |
+| パラメータ | 説明 |
 |---|---|
 | `locale` | ドキュメントの主要言語（例：`en`、`zh`）。 |
 | `translateLanguages` | ドキュメントを翻訳する言語コードのリスト（例：`[ja, fr, es]`）。 |
 | `docsDir` | 生成されたドキュメントファイルが保存されるディレクトリ。 |
-| `sourcesPath` | DocSmithが分析するためのソースコードパスまたはglobパターンのリスト（例：`['./src', './lib/**/*.js']`）。 |
+| `sourcesPath` | DocSmithが分析するソースコードのパスまたはグロブパターンのリスト（例：`['./src', './lib/**/*.js']`）。 |
 | `glossary` | 一貫した翻訳を保証するために、プロジェクト固有の用語を含むマークダウンファイル（`@glossary.md`）へのパス。 |
 
-## config.yamlの例
+## config.yaml の例
 
 以下は、完全な設定ファイルの例です。このファイルを直接編集して、いつでも設定を変更できます。
 
-```yaml Example config.yaml icon=logos:yaml
+```yaml config.yaml の例 icon=logos:yaml
 # ドキュメント公開のためのプロジェクト情報
 projectName: AIGNE DocSmith
-projectDesc: AI駆動のドキュメンテーション生成ツール。
+projectDesc: AI駆動のドキュメント生成ツール。
 projectLogo: https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png
 
 # =============================================================================
-# ドキュメンテーション設定
+# ドキュメント設定
 # =============================================================================
 
-# 目的：読者に達成してほしい主要な成果は何か？
-# オプション：getStarted, completeTasks, findAnswers, understandSystem, solveProblems, mixedPurpose
+# 目的: 読者に達成してもらいたい主な成果は何か？
+# オプション: getStarted, completeTasks, findAnswers, understandSystem, solveProblems, mixedPurpose
 documentPurpose:
   - completeTasks
   - findAnswers
 
-# 対象読者：誰がこれを最も頻繁に読むか？
-# オプション：endUsers, developers, devops, decisionMakers, supportTeams, mixedTechnical
+# 対象読者: これを最も頻繁に読むのは誰か？
+# オプション: endUsers, developers, devops, decisionMakers, supportTeams, mixedTechnical
 targetAudienceTypes:
   - developers
 
-# 読者の知識レベル：読者は通常、何を知ってアクセスするか？
-# オプション：completeBeginners, domainFamiliar, experiencedUsers, emergencyTroubleshooting, exploringEvaluating
+# 読者の知識レベル: 読者は通常、到着時に何を知っているか？
+# オプション: completeBeginners, domainFamiliar, experiencedUsers, emergencyTroubleshooting, exploringEvaluating
 readerKnowledgeLevel: domainFamiliar
 
-# ドキュメントの深さ：ドキュメントはどれだけ包括的であるべきか？
-# オプション：essentialOnly, balancedCoverage, comprehensive, aiDecide
+# ドキュメントの深さ: ドキュメントはどれだけ包括的であるべきか？
+# オプション: essentialOnly, balancedCoverage, comprehensive, aiDecide
 documentationDepth: balancedCoverage
 
-# カスタムルール：特定のドキュメント生成ルールと要件を定義する
+# カスタムルール: 特定のドキュメント生成ルールと要件を定義します
 rules: |+
   
 
-# 対象読者：特定の対象読者とその特徴を記述する
+# 対象読者: 特定の対象読者とその特徴を記述します
 targetAudience: |+
   
 
-# 用語集：プロジェクト固有の用語と定義を含むマークダウンファイルへのパス
+# 用語集: プロジェクト固有の用語と定義を含むマークダウンファイルへのパス
 # glossary: "@glossary.md"
 
 # ドキュメントの主要言語
@@ -162,11 +202,11 @@ locale: en
 # 生成されたドキュメントを保存するディレクトリ
 docsDir: .aigne/doc-smith/docs
 
-# 分析するソースコードパス
+# 分析するソースコードのパス
 sourcesPath:
   - ./
 ```
 
-設定が完了したら、プロジェクトのニーズに合ったドキュメントを作成する準備が整いました。次のステップは、生成コマンドを実行することです。
+設定が完了したら、プロジェクトのニーズに合ったドキュメントを作成する準備ができました。次のステップは、生成コマンドを実行することです。
 
 ➡️ **次へ:** [ドキュメントの生成](./features-generate-documentation.md)

package/docs/configuration.md

@@ -1,8 +1,48 @@
 # Configuration Guide
 
-AIGNE DocSmith's behavior is controlled by a central file, `config.yaml`, located at `.aigne/doc-smith/config.yaml`. This file dictates the style, target audience, languages, and structure of your documentation.
+AIGNE DocSmith's behavior is controlled by a central configuration file, `.aigne/doc-smith/config.yaml`. This file allows you to customize the style, target audience, languages, and structure of your documentation to meet your specific needs.
 
-You can create and manage this file using the interactive setup wizard by running `aigne doc init`. For a step-by-step walkthrough, see the [Interactive Setup](./configuration-interactive-setup.md) guide.
+You can create and manage this file using the interactive setup wizard by running `aigne doc init`. For a step-by-step walkthrough, please refer to the [Interactive Setup](./configuration-interactive-setup.md) guide. Alternatively, you can edit the file directly for more granular control.
+
+The following diagram illustrates the configuration workflow:
+
+```d2 Configuration Workflow
+direction: down
+
+User: {
+  shape: person
+}
+
+CLI: {
+  label: "Run Command\n'aigne doc init'"
+  shape: rectangle
+}
+
+Setup-Wizard: {
+  label: "Interactive Setup Wizard"
+  shape: rectangle
+}
+
+Config-File: {
+  label: ".aigne/doc-smith/config.yaml"
+  shape: rectangle
+}
+
+AIGNE-DocSmith-Engine: {
+  label: "AIGNE DocSmith Engine"
+}
+
+# Path 1: Interactive Setup (Recommended)
+User -> CLI: "Recommended Path"
+CLI -> Setup-Wizard: "Launches"
+Setup-Wizard -> Config-File: "Creates / Modifies"
+
+# Path 2: Manual Editing
+User -> Config-File: "Alternative Path:\nDirectly Edits"
+
+# Final Step
+Config-File -> AIGNE-DocSmith-Engine: "Configures"
+```
 
 ## Core Configuration Areas
 

package/docs/configuration.zh-TW.md

@@ -1,25 +1,65 @@
 # 設定指南
 
-AIGNE DocSmith 的行為由一個中央檔案控制，即位於 `.aigne/doc-smith/config.yaml` 的 `config.yaml`。此檔案決定了您文件的風格、目標受眾、語言和結構。
+AIGNE DocSmith 的行為由一個中央設定檔 `.aigne/doc-smith/config.yaml` 控制。此檔案可讓您自訂文件的風格、目標受眾、語言和結構，以滿足您的特定需求。
 
-您可以透過執行 `aigne doc init`，使用互動式設定精靈來建立和管理此檔案。有關逐步說明，請參閱 [互動式設定](./configuration-interactive-setup.md) 指南。
+您可以透過執行 `aigne doc init`，使用互動式設定精靈來建立和管理此檔案。如需逐步說明，請參閱 [互動式設定](./configuration-interactive-setup.md) 指南。或者，您也可以直接編輯檔案以進行更精細的控制。
+
+下圖說明了設定工作流程：
+
+```d2 設定工作流程
+direction: down
+
+User: {
+  shape: person
+}
+
+CLI: {
+  label: "執行命令\n'aigne doc init'"
+  shape: rectangle
+}
+
+Setup-Wizard: {
+  label: "互動式設定精靈"
+  shape: rectangle
+}
+
+Config-File: {
+  label: ".aigne/doc-smith/config.yaml"
+  shape: rectangle
+}
+
+AIGNE-DocSmith-Engine: {
+  label: "AIGNE DocSmith 引擎"
+}
+
+# 路徑 1：互動式設定（建議）
+User -> CLI: "建議路徑"
+CLI -> Setup-Wizard: "啟動"
+Setup-Wizard -> Config-File: "建立/修改"
+
+# 路徑 2：手動編輯
+User -> Config-File: "替代路徑：\n直接編輯"
+
+# 最後一步
+Config-File -> AIGNE-DocSmith-Engine: "設定"
+```
 
 ## 核心設定區域
 
-您的文件由幾個關鍵的設定區域塑造而成。探索這些指南，以了解如何微調生成過程的每個方面。
+您的文件由幾個關鍵的設定區域構成。請探索這些指南，以了解如何微調生成過程的各個方面。
 
 <x-cards data-columns="2">
   <x-card data-title="互動式設定" data-icon="lucide:wand-2" data-href="/configuration/interactive-setup">
     了解引導式精靈如何幫助您設定文件專案，包括設定建議和衝突偵測。
   </x-card>
   <x-card data-title="LLM 設定" data-icon="lucide:brain-circuit" data-href="/configuration/llm-setup">
-    探索如何連接不同的 AI 模型，包括使用內建的 AIGNE Hub，該中心無需 API 金鑰。
+    探索如何連接不同的 AI 模型，包括使用內建的 AIGNE Hub，無需 API 金鑰。
   </x-card>
   <x-card data-title="語言支援" data-icon="lucide:languages" data-href="/configuration/language-support">
     查看支援的語言完整列表，並了解如何設定主要語言和啟用自動翻譯。
   </x-card>
   <x-card data-title="管理偏好設定" data-icon="lucide:sliders-horizontal" data-href="/configuration/preferences">
-    了解 DocSmith 如何利用您的回饋來建立持久性規則，以及如何透過 CLI 管理它們。
+    了解 DocSmith 如何使用您的回饋來建立持續性規則，以及如何透過 CLI 管理它們。
   </x-card>
 </x-cards>
 
@@ -29,99 +69,99 @@ AIGNE DocSmith 的行為由一個中央檔案控制，即位於 `.aigne/doc-smit
 
 ### 專案資訊
 
-這些設定提供了有關您專案的基本背景資訊，用於發布文件。
+這些設定提供了關於您專案的基本情境，用於發布文件。
 
-| 參數 | 說明 |
+| Parameter | Description |
 |---|---|
-| `projectName` | 您的專案名稱。如果 `package.json` 存在，將從中偵測。 |
+| `projectName` | 您的專案名稱。如果 `package.json` 存在，則會從中偵測。 |
 | `projectDesc` | 您的專案簡短描述。從 `package.json` 偵測。 |
-| `projectLogo` | 您的專案標誌圖片的路徑或 URL。 |
+| `projectLogo` | 您專案標誌圖片的路徑或 URL。 |
 
 ### 文件策略
 
 這些參數定義了生成內容的語氣、風格和深度。
 
 #### `documentPurpose`
-定義您希望讀者達成的​​主要成果。此設定會影響文件的整體結構和重點。
+定義您希望讀者達成的最主要成果。此設定會影響文件的整體結構和重點。
 
-| 選項 | 名稱 | 說明 |
+| Option | Name | Description |
 |---|---|---|
-| `getStarted` | 快速入門 | 幫助新使用者在 30 分鐘內從零開始上手。 |
+| `getStarted` | 快速入門 | 幫助新使用者在 <30 分鐘內從零到上手。 |
 | `completeTasks` | 完成特定任務 | 引導使用者完成常見的工作流程和使用案例。 |
-| `findAnswers` | 快速找到答案 | 為所有功能和 API 提供可搜尋的參考資料。 |
+| `findAnswers` | 快速尋找答案 | 為所有功能和 API 提供可搜尋的參考資料。 |
 | `understandSystem`| 了解系統 | 解釋其運作方式以及設計決策的原因。 |
-| `solveProblems` | 解決常見問題 | 幫助使用者排除故障並解決問題。 |
+| `solveProblems` | 解決常見問題 | 幫助使用者排除故障並修復問題。 |
 | `mixedPurpose` | 服務多種目的 | 涵蓋多種需求的文件。 |
 
 #### `targetAudienceTypes`
 定義最常閱讀此文件的對象。此選擇會影響寫作風格和範例。
 
-| 選項 | 名稱 | 說明 |
+| Option | Name | Description |
 |---|---|---|
-| `endUsers` | 終端使用者（非技術人員） | 使用產品但不編寫程式碼的人。 |
-| `developers` | 整合您的產品/API 的開發人員 | 將此添加到其專案中的工程師。 |
-| `devops` | DevOps / SRE / 基礎設施團隊 | 部署、監控和維護系統的團隊。 |
+| `endUsers` | 終端使用者（非技術人員） | 使用產品但不編寫程式的人員。 |
+| `developers` | 整合您產品/API 的開發人員 | 將此產品加入其專案的工程師。 |
+| `devops` | DevOps / SRE / 基礎架構團隊 | 部署、監控和維護系統的團隊。 |
 | `decisionMakers`| 技術決策者 | 評估或規劃實施的架構師或主管。 |
 | `supportTeams` | 支援團隊 | 協助他人使用產品的人員。 |
 | `mixedTechnical`| 混合技術受眾 | 開發人員、DevOps 和其他技術使用者。 |
 
 #### `readerKnowledgeLevel`
-定義讀者通常在接觸文件時已具備的知識。這會調整文件中假設的基礎知識量。
+定義讀者通常具備的知識水平。這會調整文件中假設的基礎知識多寡。
 
-| 選項 | 名稱 | 說明 |
+| Option | Name | Description |
 |---|---|---|
-| `completeBeginners` | 完全是初學者，從零開始 | 完全不熟悉此領域/技術。 |
-| `domainFamiliar` | 以前使用過類似工具 | 了解問題領域，但對此特定解決方案不熟悉。 |
-| `experiencedUsers` | 是專家，試圖做一些特定的事情 | 需要參考資料或進階主題的常規使用者。 |
+| `completeBeginners` | 完全的初學者，從零開始 | 對此領域/技術完全陌生。 |
+| `domainFamiliar` | 曾使用過類似工具 | 了解問題領域，但對此特定解決方案不熟悉。 |
+| `experiencedUsers` | 是專家，想做特定的事情 | 需要參考資料或進階主題的常規使用者。 |
 | `emergencyTroubleshooting`| 緊急/故障排除 | 有東西壞了，需要快速修復。 |
-| `exploringEvaluating` | 正在將此工具與其他工具進行評估 | 試圖了解這是否符合他們的需求。 |
+| `exploringEvaluating` | 正在評估此工具與其他工具的比較 | 試圖了解此工具是否符合他們的需求。 |
 
 #### `documentationDepth`
 定義文件的全面程度。
 
-| 選項 | 名稱 | 說明 |
+| Option | Name | Description |
 |---|---|---|
-| `essentialOnly` | 僅包含必要內容 | 涵蓋 80% 的使用案例，保持簡潔。 |
-| `balancedCoverage`| 均衡的涵蓋範圍 | 具有良好深度和實用範例 [推薦]。 |
-| `comprehensive` | 全面 | 涵蓋所有功能、邊緣案例和進階場景。 |
-| `aiDecide` | 讓 AI 決定 | 分析程式碼複雜性並建議適當的深度。 |
+| `essentialOnly` | 僅限必要內容 | 涵蓋 80% 的使用案例，保持簡潔。 |
+| `balancedCoverage`| 均衡涵蓋 | 具備良好深度和實用範例 [建議]。 |
+| `comprehensive` | 全面詳盡 | 涵蓋所有功能、邊界案例和進階情境。 |
+| `aiDecide` | 讓 AI 決定 | 分析程式碼複雜度並建議適當的深度。 |
 
 ### 自訂指令
 
-為了更精細的控制，您可以提供自由文字指令。
+若要進行更精細的控制，您可以提供自由文字的指令。
 
-| 參數 | 說明 |
+| Parameter | Description |
 |---|---|
-| `rules` | 一個多行字串，您可以在其中定義特定的文件生成規則（例如，「始終包含效能基準測試」）。 |
+| `rules` | 一個多行字串，您可以在其中定義特定的文件生成規則（例如，「務必包含效能基準測試」）。 |
 | `targetAudience`| 一個多行字串，用以比預設選項更詳細地描述您的特定目標受眾。 |
 
 ### 語言與路徑設定
 
 這些設定控制本地化和檔案位置。
 
-| 參數 | 說明 |
+| Parameter | Description |
 |---|---|
-| `locale` | 文件的主要語言（例如，`en`、`zh`）。 |
-| `translateLanguages` | 要將文件翻譯成的語言代碼列表（例如，`[ja, fr, es]`）。 |
-| `docsDir` | 儲存生成文件的目錄。 |
-| `sourcesPath` | 供 DocSmith 分析的原始碼路徑或 glob 模式列表（例如，`['./src', './lib/**/*.js']`）。 |
-| `glossary` | 包含專案特定術語的 markdown 檔案（`@glossary.md`）路徑，以確保翻譯一致。 |
+| `locale` | 文件的主要語言（例如 `en`、`zh`）。 |
+| `translateLanguages` | 要將文件翻譯成的語言代碼列表（例如 `[ja, fr, es]`）。 |
+| `docsDir` | 儲存生成文件檔案的目錄。 |
+| `sourcesPath` | 供 DocSmith 分析的原始碼路徑或 glob 模式列表（例如 `['./src', './lib/**/*.js']`）。 |
+| `glossary` | 指向一個 markdown 檔案（`@glossary.md`）的路徑，該檔案包含專案特定術語以確保翻譯的一致性。 |
 
 ## config.yaml 範例
 
-這是一個完整的設定檔範例。您可以隨時直接編輯此檔案以變更設定。
+這是一個完整的設定檔範例。您可以隨時直接編輯此檔案以更改設定。
 
-```yaml Example config.yaml icon=logos:yaml
-# 用於文件發布的專案資訊
+```yaml config.yaml 範例 icon=logos:yaml
+# 文件發布的專案資訊
 projectName: AIGNE DocSmith
-projectDesc: 一個由 AI 驅動的文件生成工具。
+projectDesc: An AI-driven documentation generation tool.
 projectLogo: https://docsmith.aigne.io/image-bin/uploads/def424c20bbdb3c77483894fe0e22819.png
 
 # =============================================================================
 # 文件設定
 # =============================================================================
 
-# 目的：您希望讀者達成的​​主要成果是什麼？
+# 目的：您希望讀者達成的最主要成果是什麼？
 # 選項：getStarted, completeTasks, findAnswers, understandSystem, solveProblems, mixedPurpose
 documentPurpose:
   - completeTasks
@@ -132,7 +172,7 @@ documentPurpose:
 targetAudienceTypes:
   - developers
 
-# 讀者知識水平：讀者通常在接觸文件時已具備什麼知識？
+# 讀者知識水平：讀者通常具備什麼知識？
 # 選項：completeBeginners, domainFamiliar, experiencedUsers, emergencyTroubleshooting, exploringEvaluating
 readerKnowledgeLevel: domainFamiliar
 
@@ -167,6 +207,6 @@ sourcesPath:
   - ./
 ```
 
-設定完成後，您就可以開始建立符合您專案需求的文件了。下一步是執行生成指令。
+完成設定後，您就可以開始建立符合專案需求的文件了。下一步是執行生成命令。
 
-➡️ **下一步：** [生成文件](./features-generate-documentation.md)
+➡️ **下一步：** [產生文件](./features-generate-documentation.md)