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

package/docs/cli-reference.zh.md

@@ -1,82 +1,144 @@
 # CLI 命令参考
 
-本指南为所有可用的 `aigne doc` 子命令、其参数和选项提供了参考。它旨在帮助用户充分利用命令行界面。
+本指南为所有可用的 `aigne doc` 子命令及其参数和选项提供了全面的参考。它旨在帮助希望充分利用命令行的用户。
 
-通用语法是：
+通用语法为：
 
-```bash
+```bash command icon=lucide:terminal
 aigne doc <command> [options]
 ```
 
 ### 命令工作流
 
-下图展示了使用 DocSmith 的 CLI 命令创建和维护文档的典型生命周期：
+下图展示了使用 DocSmith 的 CLI 命令创建和维护文档的典型生命周期，以及它们与之交互的数据。
 
 ```d2
 direction: down
 
-Start: {
-  label: "项目设置"
-  shape: circle
+# 工件
+Source-Code: {
+  label: "源代码"
+  shape: cylinder
 }
-
-init: {
-  label: "aigne doc init\n(交互式设置)"
-  shape: rectangle
+Configuration: {
+  label: "配置\n(.aigne/doc-smith/config.yml)"
+  shape: cylinder
 }
-
-generate: {
-  label: "aigne doc generate\n(创建/更新所有文档)"
-  shape: rectangle
+Generated-Docs: {
+  label: "生成的文档"
+  shape: cylinder
+}
+Published-Docs: {
+  label: "发布的站点"
+  shape: cylinder
 }
 
-refinement-cycle: {
-  label: "优化周期"
-  shape: rectangle
-  grid-columns: 2
+# --- 核心工作流 ---
+Lifecycle: {
+  label: "文档生命周期"
+  
+  init: {
+    label: "1. 初始化\n`aigne doc init`"
+    shape: rectangle
+  }
 
-  update: {
-    label: "aigne doc update\n(优化单个文档)"
+  generate: {
+    label: "2. 生成\n`aigne doc generate`"
+    shape: rectangle
   }
-  translate: {
-    label: "aigne doc translate\n(本地化内容)"
+
+  Refinement: {
+    label: "3. 优化（迭代）"
+    grid-columns: 2
+
+    update: {
+      label: "更新\n`aigne doc update`"
+      shape: rectangle
+    }
+    translate: {
+      label: "翻译\n`aigne doc translate`"
+      shape: rectangle
+    }
   }
-}
 
-publish: {
-  label: "aigne doc publish\n(部署文档)"
-  shape: rectangle
+  publish: {
+    label: "4. 发布\n`aigne doc publish`"
+    shape: rectangle
+  }
 }
 
-End: {
-  label: "文档上线"
-  shape: circle
-  style.fill: "#a2eeaf"
+# --- 实用工具命令 ---
+Utilities: {
+  label: "实用工具命令"
+  grid-columns: 2
+  
+  prefs: {
+    label: "管理偏好\n`aigne doc prefs`"
+    shape: rectangle
+  }
+  clear: {
+    label: "清除数据\n`aigne doc clear`"
+    shape: rectangle
+  }
 }
 
-Start -> init: "可选" {
+
+# --- 连接 ---
+
+# 设置与生成
+Lifecycle.init -> Configuration: "创建"
+Source-Code -> Lifecycle.generate: "读取"
+Configuration -> Lifecycle.generate: "读取"
+Lifecycle.generate -> Generated-Docs: "创建 / 覆盖"
+Lifecycle.generate -> Lifecycle.init: {
+  label: "若无配置则运行"
   style.stroke-dash: 4
 }
-init -> generate: "配置"
-Start -> generate: "直接"
-generate -> refinement-cycle: "优化"
-refinement-cycle -> publish: "就绪"
-generate -> publish: "直接部署"
-publish -> End
+
+# 优化循环
+Generated-Docs <-> Lifecycle.Refinement: "读取和写入"
+
+# 发布
+Lifecycle.Refinement -> Lifecycle.publish
+Lifecycle.publish -> Published-Docs: "上传至"
+
+# 实用工具连接
+Utilities.prefs -> Configuration: "读取"
+Utilities.clear -> Configuration: "删除"
+Utilities.clear -> Generated-Docs: "删除"
 ```
 
 ---
 
+## `aigne doc init`
+
+手动启动交互式配置向导。这对于设置新项目或修改现有项目的配置非常有用。该向导会引导您定义源代码路径、设置输出目录、选择语言以及定义文档的风格和目标受众。
+
+### 使用示例
+
+**启动设置向导：**
+
+```bash
+aigne doc init
+```
+![交互式设置向导完成截图。](../assets/screenshots/doc-complete-setup.png)
+
+有关如何根据您的需求定制 DocSmith 的更多详细信息，请参阅[配置指南](./configuration.md)。
+
+---
+
 ## `aigne doc generate`
 
-分析您的源代码，并根据您的配置生成一套完整的文档。如果找不到配置，它会自动启动交互式设置向导。
+分析您的源代码并根据您的配置生成一套完整的文档。如果未找到配置，它将自动启动交互式设置向导（`aigne doc init`）。
+
+![generate 命令运行截图。](../assets/screenshots/doc-generate.png)
 
 ### 选项
 
-| 选项              | 类型    | 描述                                                                                                   |
-| ------------------- | ------- | ------------------------------------------------------------------------------------------------------------- |
-| `--feedback`        | string  | 提供反馈以调整和优化整体文档结构。                                   |
-| `--forceRegenerate` | boolean | 丢弃现有内容并从头开始重新生成所有文档。                                     |
+| Option              | Type    | Description                                                                                              |
+| :------------------ | :------ | :------------------------------------------------------------------------------------------------------- |
+| `--forceRegenerate` | boolean | 丢弃现有内容并从头开始重新生成所有文档。                                |
+| `--feedback`        | string  | 提供反馈以调整和优化整体文档结构。                              |
 | `--model`           | string  | 指定用于生成的特定大语言模型（例如，`openai:gpt-4o`）。此选项将覆盖默认设置。 |
 
 ### 使用示例
@@ -96,27 +158,29 @@ aigne doc generate --forceRegenerate
 **通过反馈优化文档结构：**
 
 ```bash
-aigne doc generate --feedback "为 API 示例添加一个新部分，并删除‘关于’页面。"
+aigne doc generate --feedback "Add a new section for API examples and remove the 'About' page."
 ```
 
-**使用 AIGNE Hub 中的特定模型进行生成：**
+**使用特定模型生成：**
 
 ```bash
-aigne doc generate --model google:gemini-1.5-flash
+aigne doc generate --model openai:gpt-4o
 ```
 
 ---
 
 ## `aigne doc update`
 
-优化并重新生成特定文档。您可以以交互方式运行它来选择文档，或使用选项直接指定文档。这对于根据反馈进行有针对性的改进非常有用，而无需重新生成整个项目。
+优化并重新生成特定文档。您可以以交互方式运行它来选择文档，或直接使用选项指定文档。这对于根据反馈进行有针对性的改进非常有用，而无需重新生成整个项目。
+
+![update 命令运行截图。](../assets/screenshots/doc-update.png)
 
 ### 选项
 
-| 选项     | 类型  | 描述                                                                                 |
-| ---------- | ----- | ------------------------------------------------------------------------------------------- |
-| `--docs`     | array | 要重新生成的文档路径列表。可多次使用。                         |
-| `--feedback` | string | 提供具体反馈以改进所选文档的内容。              |
+| Option     | Type  | Description                                                                 |
+| :--------- | :---- | :-------------------------------------------------------------------------- |
+| `--docs`     | array | 要重新生成的文档路径列表。可多次指定。    |
+| `--feedback` | string  | 提供具体反馈以改进所选文档的内容。 |
 
 ### 使用示例
 
@@ -129,23 +193,25 @@ aigne doc update
 **使用有针对性的反馈更新特定文档：**
 
 ```bash
-aigne doc update --docs overview.md --feedback "添加更详细的常见问题解答条目"
+aigne doc update --docs /overview --feedback "Add more detailed FAQ entries"
 ```
 
 ---
 
 ## `aigne doc translate`
 
-将现有文档翻译成一种或多种语言。可以以交互方式运行以选择文档和语言，也可以通过将它们指定为参数以非交互方式运行。
+将现有文档翻译成一种或多种语言。可以以交互方式运行它来选择文档和语言，也可以通过指定参数以非交互方式运行。
+
+![translate 命令运行截图。](../assets/screenshots/doc-translate.png)
 
 ### 选项
 
-| 选项       | 类型  | 描述                                                                                                |
-| ------------ | ----- | ---------------------------------------------------------------------------------------------------------- |
-| `--docs`       | array | 要翻译的文档路径列表。可多次使用。                                         |
-| `--langs`      | array | 目标语言代码列表（例如 `zh`、`ja`）。可多次使用。                            |
-| `--feedback`   | string | 提供反馈以提高翻译质量。                                               |
-| `--glossary`   | string | 术语表文件的路径，以确保跨语言术语的一致性。使用 `@path/to/glossary.md`。 |
+| Option     | Type  | Description                                                                          |
+| :--------- | :---- | :----------------------------------------------------------------------------------- |
+| `--docs`     | array | 要翻译的文档路径列表。可多次指定。              |
+| `--langs`    | array | 目标语言代码列表（例如，`zh-CN`、`ja`）。可多次指定。 |
+| `--feedback` | string  | 提供反馈以提高翻译质量。                       |
+| `--glossary` | string  | 词汇表文件的路径，以确保跨语言的术语一致性。使用 `@path/to/glossary.md`。 |
 
 ### 使用示例
 
@@ -158,26 +224,28 @@ aigne doc translate
 **将特定文档翻译成中文和日文：**
 
 ```bash
-aigne doc translate --langs zh --langs ja --docs examples.md --docs overview.md
+aigne doc translate --langs zh-CN --langs ja --docs /features/generate-documentation --docs /overview
 ```
 
-**使用术语表和反馈进行翻译以获得更好的质量：**
+**使用词汇表和反馈进行翻译以提高质量：**
 
 ```bash
-aigne doc translate --glossary @glossary.md --feedback "始终如一地使用技术术语"
+aigne doc translate --glossary @glossary.md --feedback "Use technical terminology consistently"
 ```
 
 ---
 
 ## `aigne doc publish`
 
-将您生成的文档发布到 Discuss Kit 平台。您可以发布到官方的 AIGNE DocSmith 平台，也可以发布到您自己托管的实例。
+发布您的文档并生成一个可共享的链接。此命令会将您的内容上传到 Discuss Kit 实例。您可以使用官方的 AIGNE DocSmith 平台，也可以运行您自己的 [Discuss Kit](https://www.web3kit.rocks/discuss-kit) 实例。
+
+![publish 命令运行截图。](../assets/screenshots/doc-publish.png)
 
 ### 选项
 
-| 选项     | 类型   | 描述                                                                                          |
-| ---------- | ------ | ---------------------------------------------------------------------------------------------------- |
-| `--appUrl` | string | 您自托管的 Discuss Kit 实例的 URL。如果未提供，该命令将以交互方式运行。 |
+| Option   | Type   | Description                                                                                             |
+| :------- | :----- | :------------------------------------------------------------------------------------------------------ |
+| `--appUrl` | string | 您的自托管 Discuss Kit 实例的 URL。如果未提供，该命令将以交互模式运行。 |
 
 ### 使用示例
 
@@ -195,16 +263,49 @@ aigne doc publish --appUrl https://your-discuss-kit-instance.com
 
 ---
 
-## `aigne doc init`
+## `aigne doc prefs`
 
-手动启动交互式配置向导。这对于设置新项目或修改现有项目的配置非常有用。该向导会引导您定义源代码路径、设置输出目录、选择语言以及定义文档的风格和目标受众。
+管理用户偏好和由反馈驱动的规则。随着时间的推移，DocSmith 会从您的反馈中学习并创建持久的偏好设置。此命令允许您查看、切换或移除这些学习到的规则。
+
+### 选项
+
+| Option   | Type    | Description                                                                |
+| :------- | :------ | :------------------------------------------------------------------------- |
+| `--list`   | boolean | 列出所有已保存的偏好设置。                                               |
+| `--remove` | boolean | 以交互方式提示选择并移除一个或多个偏好设置。        |
+| `--toggle` | boolean | 以交互方式提示选择并切换偏好设置的激活状态。 |
+| `--id`     | array   | 指定一个或多个偏好 ID 以直接移除或切换。         |
 
 ### 使用示例
 
-**启动设置向导：**
+**列出所有已保存的偏好设置：**
 
 ```bash
-aigne doc init
+aigne doc prefs --list
 ```
 
-有关如何根据您的需求定制 DocSmith 的更多详细信息，请参阅[配置指南](./configuration.md)。
+**启动交互式移除模式：**
+
+```bash
+aigne doc prefs --remove
+```
+
+**按 ID 切换特定偏好设置：**
+
+```bash
+aigne doc prefs --toggle --id "pref_2a1dfe2b09695aab"
+```
+
+---
+
+## `aigne doc clear`
+
+启动一个交互式会话以清除本地存储的数据。此命令可用于移除生成的文档、文档结构配置或缓存的身份验证令牌。
+
+### 使用示例
+
+**启动交互式清理过程：**
+
+```bash
+aigne doc clear
+```

package/docs/configuration-interactive-setup.ja.md

@@ -1,6 +1,6 @@
-# 対話型セットアップ
+# インタラクティブなセットアップ
 
-AIGNE DocSmithには、プロジェクト設定を効率化するための対話型セットアップウィザードが含まれており、`aigne doc init`コマンドで起動します。このガイド付きプロセスでは、ドキュメントの目標に関する一連の質問が行われ、その回答から`config.yaml`ファイルが生成されます。これは、設定エラーを防ぎ、入力に基づいて具体的な推奨事項を提供するため、新しいドキュメントプロジェクトを開始する際に推奨される方法です。
+AIGNE DocSmithには、`aigne doc init`コマンドで起動するインタラクティブなセットアップウィザードが含まれており、プロジェクトの設定を効率化します。このガイド付きプロセスでは、ドキュメントの目標に関する一連の質問が行われ、回答に基づいて`config.yaml`ファイルが生成されます。設定エラーを防ぎ、入力に基づいて具体的な推奨事項を提供するため、新しいドキュメントプロジェクトを開始する際に推奨される方法です。
 
 ## ウィザードの実行
 
@@ -10,22 +10,22 @@ AIGNE DocSmithには、プロジェクト設定を効率化するための対話
 npx aigne doc init
 ```
 
-ウィザードは、ドキュメントを設定するための8ステップのプロセスを案内します。
+ウィザードが8つのステップでドキュメントの設定を案内します。
 
 ## ガイド付きプロセス
 
-ウィザードは、以下の主要な設定詳細を尋ねます。
+ウィザードでは、以下の主要な設定項目についてプロンプトが表示されます。
 
-1.  **主な目標**: 読者の主な目的を定義します（例：入門、回答の検索）。
-2.  **対象読者**: ドキュメントの主な読者を指定します（例：非技術的なエンドユーザー、開発者）。
-3.  **読者の知識レベル**: 対象読者の典型的な初期知識を評価します。
+1.  **プライマリゴール**: 読者の主な目的を定義します（例：利用開始、回答の検索）。
+2.  **ターゲットオーディエンス**: ドキュメントの主な読者を指定します（例：非技術系のエンドユーザー、開発者）。
+3.  **読者の知識レベル**: 読者の一般的な初期知識を評価します。
 4.  **ドキュメントの深さ**: コンテンツの詳細レベルと範囲を決定します。
-5.  **主な言語**: ドキュメントの主要言語を設定します。
-6.  **翻訳言語**: 翻訳のための追加言語を選択します。
+5.  **プライマリ言語**: ドキュメントの主要言語を設定します。
+6.  **翻訳言語**: 翻訳用の追加言語を選択します。
 7.  **出力ディレクトリ**: 生成されたドキュメントファイルの場所を指定します。
-8.  **ソースコードのパス**: globパターンをサポートし、分析対象のファイルとディレクトリを定義します。
+8.  **ソースコードパス**: globパターンをサポートし、分析するファイルとディレクトリを定義します。
 
-## 設定支援
+## アシスト付き設定
 
 ウィザードは、一貫性のある効果的な設定を作成するために、事前定義された一連のルールを使用します。
 
@@ -33,87 +33,86 @@ npx aigne doc init
 direction: down
 
 User-Selections: {
-  label: "1. User provides input\n(Purpose, Audience, etc.)"
+  label: "1. ユーザーが入力\n(目的、オーディエンスなど)"
   shape: rectangle
 }
 
 Wizard-Engine: {
-  label: "2. Wizard's Rule Engine"
+  label: "2. ウィザードのルールエンジン"
   shape: rectangle
   grid-columns: 2
 
   Filtering: {
-    label: "Option Filtering\n(Prevents incompatible selections)"
+    label: "オプションフィルタリング\n(互換性のない選択を防止)"
   }
 
   Conflict-Detection: {
-    label: "Conflict Detection\n(Identifies complex needs)"
+    label: "競合検出\n(複雑なニーズを特定)"
   }
 }
 
 Guided-Experience: {
-  label: "3. Guided Experience"
+  label: "3. ガイド付きエクスペリエンス"
   shape: rectangle
-  content: "User sees simplified, relevant options"
+  content: "ユーザーには簡素化された関連オプションが表示される"
 }
 
 Final-Config: {
-  label: "4. Final Configuration"
-  content: "config.yaml is generated with\nconflict resolution strategies"
+  label: "4. 最終設定"
+  content: "config.yamlが競合解決戦略とともに生成される"
 }
 
 User-Selections -> Wizard-Engine
 Wizard-Engine.Filtering -> Guided-Experience
 Wizard-Engine.Conflict-Detection -> Final-Config
-Guided-Experience -> User-Selections: "Refines"
+Guided-Experience -> User-Selections: "絞り込み"
 ```
 
-### デフォルトの提案とオプションのフィルタリング
+### オプションフィルタリング
 
-選択を行うと、ウィザードはデフォルトを提供し、後続のオプションをフィルタリングして、論理的な設定に導きます。これは、質問間の競合ルールセットに基づいています。
+選択を行うと、ウィザードは後続のオプションをフィルタリングして、論理的な設定に導きます。これは、互換性のない選択を防ぐための一連の質問間競合ルールに基づいています。
 
--   **デフォルトの提案**: 主な目標として「すぐに始める」を選択すると、ウィザードは読者の知識レベルとして「完全な初心者」を推奨します。
--   **リアルタイムフィルタリング**: 対象読者が「エンドユーザー（非技術的）」の場合、ウィザードは「専門家」の知識レベルを非表示にします。このルールの理由は、非技術的なユーザーは通常、経験豊富な技術ユーザーではないため、互換性のない選択を防ぐためです。
+たとえば、ターゲットオーディエンスとして「エンドユーザー（非技術者）」を選択した場合、ウィザードは知識レベルの選択肢である「専門家である」を非表示にします。このルールの理由は、「非技術系のユーザーは通常、経験豊富な技術ユーザーではない」ということであり、非論理的な選択を防ぎます。
 
 ### 競合の検出と解決
 
-場合によっては、非技術的な**エンドユーザー**と専門家の**開発者**の両方向けにドキュメントを作成するなど、効果的なドキュメント構造を必要とする複数の目標や対象者がいることがあります。ウィザードはこれらを「解決可能な競合」として識別します。
+場合によっては、非技術系の**エンドユーザー**と専門家の**開発者**の両方向けにドキュメントを作成するなど、効果的なドキュメント構造を必要とする複数の目標やオーディエンスが存在することがあります。ウィザードはこれらを「解決可能な競合」として識別します。
 
-次に、これらのニーズにドキュメント構造内で対応するための戦略を策定します。エンドユーザー対開発者の例では、解決戦略として別々のユーザーパスを作成します。
+そして、これらのニーズにドキュメント構造内で対応するための戦略を策定します。エンドユーザー対開発者の例では、解決戦略として別々のユーザーパスを作成します。
 
--   **ユーザーガイドパス**: 平易な言葉を使用し、UIの操作に焦点を当て、ビジネスの成果を志向します。
+-   **ユーザーガイドパス**: 平易な言葉を使用し、UIの操作に焦点を当て、ビジネス成果を志向します。
 -   **開発者ガイドパス**: コード中心で技術的に正確であり、SDKの例や設定スニペットを含みます。
 
-このアプローチにより、最終的なドキュメントは、単一の混乱したコンテンツの混合物を作成するのではなく、複数の対象者に効果的に対応できるように構成されます。
+このアプローチにより、最終的なドキュメントは、単一の混乱したコンテンツの混合物を作成するのではなく、複数のオーディエンスに効果的に対応できるように構成されます。
 
 ## 生成される出力
 
-ウィザードを完了すると、プロジェクトに`config.yaml`ファイルが保存されます。このファイルは完全にコメント化されており、各オプションを説明し、利用可能なすべての選択肢をリストアップしているため、後で手動で確認・修正するのが簡単です。
+ウィザードを完了すると、プロジェクトに`config.yaml`ファイルが保存されます。このファイルは完全にコメント化されており、各オプションの説明と利用可能なすべての選択肢がリストされているため、後で手動で確認したり変更したりするのが簡単です。
 
 以下は生成されたファイルのスニペットです。
 
 ```yaml config.yaml icon=logos:yaml
-# ドキュメント公開のためのプロジェクト情報
+# ドキュメント公開用のプロジェクト情報
 projectName: your-project-name
 projectDesc: Your project description.
 projectLogo: ""
 
 # =============================================================================
-# ドキュメント設定
+# Documentation Configuration
 # =============================================================================
 
-# 目的: 読者に達成してほしい主な成果は何ですか？
-# 利用可能なオプション（必要に応じてコメントを解除して変更してください）：
-#   getStarted       - すぐに始める：新規ユーザーが30分以内にゼロから作業を開始できるように支援します
-#   completeTasks    - 特定のタスクを完了する：一般的なワークフローやユースケースをユーザーに案内します
+# Purpose: What's the main outcome you want readers to achieve?
+# Available options (uncomment and modify as needed):
+#   getStarted       - すぐに始める: 新規ユーザーが30分未満でゼロから作業を開始できるように支援
+#   completeTasks    - 特定のタスクを完了する: 一般的なワークフローやユースケースをユーザーに案内
 documentPurpose:
   - completeTasks
   - findAnswers
 
-# 対象読者: これを最も頻繁に読むのは誰ですか？
-# 利用可能なオプション（必要に応じてコメントを解除して変更してください）：
-#   endUsers         - エンドユーザー（非技術的）：製品を使用するがコーディングはしない人々
-#   developers       - 開発者（製品/APIを統合）：これを自分のプロジェクトに追加するエンジニア
+# Target Audience: Who will be reading this most often?
+# Available options (uncomment and modify as needed):
+#   endUsers         - エンドユーザー (非技術者): 製品を使用するがコーディングはしない人々
+#   developers       - 開発者 (製品/APIを統合): これを自分のプロジェクトに追加するエンジニア
 targetAudienceTypes:
   - endUsers
   - developers
@@ -121,15 +120,19 @@ targetAudienceTypes:
 # ... その他の設定
 ```
 
+完了すると、ターミナルに確認メッセージが表示されます。
+
+![インタラクティブなセットアップウィザードが正常に完了したことを示すターミナルウィンドウ。](../assets/screenshots/doc-complete-setup.png)
+
 ## 次のステップ
 
-設定ファイルが準備できたので、ドキュメントの生成、翻訳、または公開を行う準備が整いました。
+設定ファイルが準備できたので、ドキュメントを生成、翻訳、または公開する準備が整いました。
 
 <x-cards>
   <x-card data-title="ドキュメントの生成" data-icon="lucide:play-circle" data-href="/features/generate-documentation">
-    単一のコマンドを使用して、ソースコードから完全なドキュメントセットを自動的に作成する方法を学びます。
+    単一のコマンドを使用してソースコードから完全なドキュメントセットを自動的に作成する方法を学びます。
   </x-card>
   <x-card data-title="設定ガイド" data-icon="lucide:settings" data-href="/configuration">
-    利用可能なすべての設定を深く掘り下げ、`config.yaml`ファイルを手動で微調整する方法を学びます。
+    利用可能なすべての設定を深く掘り下げ、config.yamlファイルを手動で微調整する方法を学びます。
   </x-card>
 </x-cards>

package/docs/configuration-interactive-setup.md

@@ -1,6 +1,6 @@
 # Interactive Setup
 
-AIGNE DocSmith includes an interactive setup wizard, launched with the `aigne doc init` command, to streamline project configuration. This guided process asks a series of questions about your documentation goals and generates a `config.yaml` file from your answers. It is the recommended method for starting a new documentation project, as it helps prevent configuration errors and provides specific recommendations based on your inputs.
+AIGNE DocSmith includes an interactive setup wizard, launched with the `aigne doc init` command, to streamline project configuration. This guided process asks a series of questions about your documentation goals and generates a `config.yaml` file based on your answers. It is the recommended method for starting a new documentation project, as it helps prevent configuration errors and provides specific recommendations based on your inputs.
 
 ## Running the Wizard
 
@@ -68,18 +68,17 @@ Wizard-Engine.Conflict-Detection -> Final-Config
 Guided-Experience -> User-Selections: "Refines"
 ```
 
-### Default Suggestions and Option Filtering
+### Option Filtering
 
-As you make selections, the wizard provides defaults and filters subsequent options to guide you toward a logical configuration. This is based on a set of cross-question conflict rules.
+As you make selections, the wizard filters subsequent options to guide you toward a logical configuration. This is based on a set of cross-question conflict rules that prevent incompatible choices.
 
--   **Default Suggestions**: If you select "Get started quickly" as your primary goal, the wizard will recommend "Is a total beginner" as the reader's knowledge level.
--   **Real-time Filtering**: If your target audience is "End users (non-technical)," the wizard will hide the "Is an expert" knowledge level. The rule's reasoning is that non-technical users are typically not experienced technical users, thus preventing an incompatible selection.
+For example, if you select "End users (non-technical)" as your target audience, the wizard will hide the "Is an expert" knowledge level option. The rule's reasoning is that "Non-technical users are typically not experienced technical users," thus preventing an illogical selection.
 
 ### Conflict Detection and Resolution
 
 In some cases, you may have multiple goals or audiences that require a specific documentation structure to be effective, such as creating documentation for both non-technical **End Users** and expert **Developers**. The wizard identifies these as "resolvable conflicts."
 
-It then formulates a strategy to address these needs within the document structure. For the End User vs. Developer example, the resolution strategy is to create separate user paths:
+It then formulates a strategy to address these needs within the documentation structure. For the End User vs. Developer example, the resolution strategy is to create separate user paths:
 
 -   **User Guide Path**: Uses plain language, focuses on UI interactions, and is oriented toward business outcomes.
 -   **Developer Guide Path**: Is code-first, technically precise, and includes SDK examples and configuration snippets.
@@ -121,6 +120,10 @@ targetAudienceTypes:
 # ... other settings
 ```
 
+Upon completion, you will see a confirmation message in your terminal.
+
+![A terminal window showing the successful completion of the interactive setup wizard.](../assets/screenshots/doc-complete-setup.png)
+
 ## Next Steps
 
 With your configuration file in place, you are ready to generate, translate, or publish your documentation.