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

package/docs/cli-reference.zh-TW.md

@@ -1,83 +1,142 @@
 # CLI 命令參考
 
-本指南為所有可用的 `aigne doc` 子命令、其參數和選項提供參考。它旨在幫助使用者充分利用命令列介面。
+本指南為所有可用的 `aigne doc` 子命令、其參數和選項提供了全面的參考。它旨在幫助使用者充分利用命令列介面的全部潛力。
 
 一般語法為：
 
-```bash
+```bash command
 aigne doc <command> [options]
 ```
 
 ### 命令工作流程
 
-下圖說明了使用 DocSmith 的 CLI 命令建立和維護文件的典型生命週期：
+下圖說明了使用 DocSmith 的 CLI 命令建立和維護文件的一般生命週期，以及它們互動的資料。
 
 ```d2
 direction: down
 
-Start: {
-  label: "專案設定"
-  shape: circle
+# Artifacts
+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
+# --- Core Workflow ---
+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"
+# --- Utility Commands ---
+Utilities: {
+  label: "工具命令"
+  grid-columns: 2
+  
+  prefs: {
+    label: "檢視設定\n`aigne doc prefs`"
+    shape: rectangle
+  }
+  clear: {
+    label: "清除資料\n`aigne doc clear`"
+    shape: rectangle
+  }
 }
 
-Start -> init: "可選" {
+
+# --- Connections ---
+
+# Setup and Generation
+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
+
+# Refinement Loop
+Generated-Docs <-> Lifecycle.Refinement: "讀取與寫入"
+
+# Publishing
+Lifecycle.Refinement -> Lifecycle.publish
+Lifecycle.publish -> Published-Docs: "上傳至"
+
+# Utility Connections
+Utilities.prefs -> Configuration: "讀取"
+Utilities.clear -> Configuration: "刪除"
+Utilities.clear -> Generated-Docs: "刪除"
+```
+
+---
+
+## `aigne doc init`
+
+手動啟動互動式設定精靈。這對於設定新專案或修改現有專案的設定很有用。此精靈會引導您定義原始碼路徑、設定輸出目錄、選擇語言，以及定義文件的風格和目標受眾。
+
+### 使用範例
+
+**啟動設定精靈：**
+
+```bash
+aigne doc init
 ```
 
+有關如何根據您的需求客製化 DocSmith 的更多詳細資訊，請參閱 [設定指南](./configuration.md)。
+
 ---
 
 ## `aigne doc generate`
 
-分析您的原始碼並根據您的設定產生一套完整的文件。如果找不到設定，它會自動啟動互動式設定精靈。
+分析您的原始碼並根據您的設定產生一套完整的文件。如果找不到設定，它會自動啟動互動式設定精靈 (`aigne doc init`)。
 
 ### 選項
 
 | Option              | Type    | Description                                                                                                   |
 | ------------------- | ------- | ------------------------------------------------------------------------------------------------------------- |
-| `--feedback`        | string  | 提供回饋以調整和優化整體文件結構。                                                                            |
-| `--forceRegenerate` | boolean | 捨棄現有內容並從頭開始重新產生所有文件。                                                                        |
-| `--model`           | string  | 指定用於產生的特定大型語言模型（例如 `openai:gpt-4o`）。此選項會覆蓋預設設定。                                    |
+| `--forceRegenerate` | boolean | 捨棄現有內容並從頭開始重新產生所有文件。                                     |
+| `--feedback`        | string  | 提供回饋以調整和優化整體文件結構。                                   |
+| `--model`           | string  | 指定用於產生的特定大型語言模型（例如 `anthropic:claude-3-5-sonnet`）。此選項會覆寫預設設定。 |
 
 ### 使用範例
 
@@ -99,24 +158,24 @@ aigne doc generate --forceRegenerate
 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`
 
-優化並重新產生特定文件。您可以以互動方式執行以選擇文件，或使用選項直接指定。這對於根據回饋進行有針對性的改進，而無需重新產生整個專案非常有用。
+優化並重新產生特定文件。您可以以互動方式執行以選擇文件，或直接使用選項指定它們。這對於根據回饋進行有針對性的改進，而無需重新產生整個專案，非常有用。
 
 ### 選項
 
 | Option     | Type  | Description                                                                                 |
 | ---------- | ----- | ------------------------------------------------------------------------------------------- |
-| `--docs`     | array | 要重新產生的文件路徑列表。可多次使用。                                                        |
-| `--feedback` | string | 提供具體回饋以改善所選文件的內容。                                                            |
+| `--docs`     | array | 要重新產生的文件路徑列表。可多次指定。                         |
+| `--feedback` | string | 提供具體回饋以改善所選文件的內容。              |
 
 ### 使用範例
 
@@ -129,23 +188,23 @@ aigne doc update
 **使用針對性回饋更新特定文件：**
 
 ```bash
-aigne doc update --docs overview.md --feedback "Add more detailed FAQ entries"
+aigne doc update --docs /overview.md --feedback "Add more detailed FAQ entries"
 ```
 
 ---
 
 ## `aigne doc translate`
 
-將現有文件翻譯成一種或多種語言。可以互動方式執行以選擇文件和語言，或透過將它們指定為參數以非互動方式執行。
+將現有文件翻譯成一種或多種語言。它可以以互動方式執行以選擇文件和語言，也可以透過將它們指定為參數以非互動方式執行。
 
 ### 選項
 
 | Option       | Type  | Description                                                                                                |
 | ------------ | ----- | ---------------------------------------------------------------------------------------------------------- |
-| `--docs`       | array | 要翻譯的文件路徑列表。可多次使用。                                                                           |
-| `--langs`      | array | 目標語言代碼列表（例如 `zh`、`ja`）。可多次使用。                                                               |
-| `--feedback`   | string | 提供回饋以改善翻譯品質。                                                                                   |
-| `--glossary`   | string | 詞彙表檔案的路徑，以確保跨語言的術語一致性。使用 `@path/to/glossary.md`。                                  |
+| `--docs`       | array | 要翻譯的文件路徑列表。可多次指定。                                         |
+| `--langs`      | array | 目標語言代碼列表（例如 `zh-CN`、`ja`）。可多次指定。                            |
+| `--feedback`   | string | 提供回饋以改善翻譯品質。                                               |
+| `--glossary`   | string | 詞彙表檔案的路徑，以確保跨語言的術語一致性。使用 `@path/to/glossary.md`。 |
 
 ### 使用範例
 
@@ -158,10 +217,10 @@ 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.md --docs /overview.md
 ```
 
-**使用詞彙表和回饋進行翻譯以獲得更高品質：**
+**使用詞彙表和回饋進行翻譯以提高品質：**
 
 ```bash
 aigne doc translate --glossary @glossary.md --feedback "Use technical terminology consistently"
@@ -171,13 +230,13 @@ aigne doc translate --glossary @glossary.md --feedback "Use technical terminolog
 
 ## `aigne doc publish`
 
-將您產生的文件發佈到 Discuss Kit 平台。您可以發佈到官方的 AIGNE DocSmith 平台或您自己託管的實例。
+發佈您的文件並產生一個可分享的連結。此命令會將您的內容上傳到一個 Discuss Kit 實例。您可以使用官方的 AIGNE DocSmith 平台或執行您自己的 [Discuss Kit](https://www.web3kit.rocks/discuss-kit) 實例。
 
 ### 選項
 
 | Option     | Type   | Description                                                                                          |
 | ---------- | ------ | ---------------------------------------------------------------------------------------------------- |
-| `--appUrl` | string | 您自行託管的 Discuss Kit 實例的 URL。如果未提供，此命令將以互動方式執行。                                |
+| `--appUrl` | string | 您自行託管的 Discuss Kit 實例的 URL。若未提供，此命令將以互動模式執行。 |
 
 ### 使用範例
 
@@ -187,7 +246,7 @@ aigne doc translate --glossary @glossary.md --feedback "Use technical terminolog
 aigne doc publish
 ```
 
-**直接發佈到自行託管的實例：**
+**直接發佈至自行託管的實例：**
 
 ```bash
 aigne doc publish --appUrl https://your-discuss-kit-instance.com
@@ -195,16 +254,28 @@ aigne doc publish --appUrl https://your-discuss-kit-instance.com
 
 ---
 
-## `aigne doc init`
+## `aigne doc prefs`
 
-手動啟動互動式設定精靈。這對於設定新專案或修改現有專案的設定很有用。此精靈會引導您定義原始碼路徑、設定輸出目錄、選擇語言以及定義文件的風格和目標受眾。
+顯示專案目前的設定。這是一個唯讀命令，可幫助您驗證在 `init` 或 `generate` 過程中應用的設定。
 
 ### 使用範例
 
-**啟動設定精靈：**
+**檢視目前專案設定：**
 
 ```bash
-aigne doc init
+aigne doc prefs
 ```
 
-有關如何根據您的需求量身訂做 DocSmith 的更多詳細資訊，請參閱 [設定指南](./configuration.md)。
+---
+
+## `aigne doc clear`
+
+啟動一個互動式會話以清除本地儲存的資料。這可用於移除產生的文件、文件結構設定或快取的驗證權杖。
+
+### 使用範例
+
+**啟動互動式清理程序：**
+
+```bash
+aigne doc clear
+```

package/docs/cli-reference.zh.md

@@ -1,85 +1,144 @@
 # CLI 命令参考
 
-本指南为所有可用的 `aigne doc` 子命令、其参数和选项提供了参考。它旨在帮助用户充分利用命令行界面。
+本指南为所有可用的 `aigne doc` 子命令及其参数和选项提供了全面的参考。它旨在帮助用户充分利用命令行界面。
 
-通用语法是：
+通用语法为：
 
-```bash
+```bash command
 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
 ```
 
+有关如何根据您的需求定制 DocSmith 的更多详细信息，请参阅[配置指南](./configuration.md)。
+
 ---
 
 ## `aigne doc generate`
 
-分析您的源代码，并根据您的配置生成一套完整的文档。如果找不到配置，它会自动启动交互式设置向导。
+分析您的源代码并根据您的配置生成一套完整的文档。如果未找到配置，它将自动启动交互式设置向导 (`aigne doc init`)。
 
 ### 选项
 
-| 选项              | 类型    | 描述                                                                                                   |
+| 选项 | 类型 | 描述 |
 | ------------------- | ------- | ------------------------------------------------------------------------------------------------------------- |
-| `--feedback`        | string  | 提供反馈以调整和优化整体文档结构。                                   |
-| `--forceRegenerate` | boolean | 丢弃现有内容并从头开始重新生成所有文档。                                     |
-| `--model`           | string  | 指定用于生成的特定大语言模型（例如，`openai:gpt-4o`）。此选项将覆盖默认设置。 |
+| `--forceRegenerate` | boolean | 丢弃现有内容并从头开始重新生成所有文档。 |
+| `--feedback` | string | 提供反馈以调整和优化整体文档结构。 |
+| `--model` | string | 指定用于生成的特定大语言模型（例如 `anthropic:claude-3-5-sonnet`）。此选项会覆盖默认设置。 |
 
-### 使用示例
+### 用法示例
 
 **生成或更新文档：**
 
@@ -96,29 +155,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`
 
-优化并重新生成特定文档。您可以以交互方式运行它来选择文档，或使用选项直接指定文档。这对于根据反馈进行有针对性的改进非常有用，而无需重新生成整个项目。
+优化并重新生成特定文档。您可以以交互方式运行它来选择文档，或直接使用选项指定文档。这对于根据反馈进行有针对性的改进非常有用，而无需重新生成整个项目。
 
 ### 选项
 
-| 选项     | 类型  | 描述                                                                                 |
+| 选项 | 类型 | 描述 |
 | ---------- | ----- | ------------------------------------------------------------------------------------------- |
-| `--docs`     | array | 要重新生成的文档路径列表。可多次使用。                         |
-| `--feedback` | string | 提供具体反馈以改进所选文档的内容。              |
+| `--docs` | array | 要重新生成的文档路径列表。可以多次指定。 |
+| `--feedback` | string | 提供具体反馈以改进所选文档的内容。 |
 
-### 使用示例
+### 用法示例
 
 **启动交互式会话以选择要更新的文档：**
 
@@ -129,25 +188,25 @@ aigne doc update
 **使用有针对性的反馈更新特定文档：**
 
 ```bash
-aigne doc update --docs overview.md --feedback "添加更详细的常见问题解答条目"
+aigne doc update --docs /overview.md --feedback "Add more detailed FAQ entries"
 ```
 
 ---
 
 ## `aigne doc translate`
 
-将现有文档翻译成一种或多种语言。可以以交互方式运行以选择文档和语言，也可以通过将它们指定为参数以非交互方式运行。
+将现有文档翻译成一种或多种语言。可以以交互方式运行它来选择文档和语言，也可以通过将它们指定为参数以非交互方式运行。
 
 ### 选项
 
-| 选项       | 类型  | 描述                                                                                                |
+| 选项 | 类型 | 描述 |
 | ------------ | ----- | ---------------------------------------------------------------------------------------------------------- |
-| `--docs`       | array | 要翻译的文档路径列表。可多次使用。                                         |
-| `--langs`      | array | 目标语言代码列表（例如 `zh`、`ja`）。可多次使用。                            |
-| `--feedback`   | string | 提供反馈以提高翻译质量。                                               |
-| `--glossary`   | string | 术语表文件的路径，以确保跨语言术语的一致性。使用 `@path/to/glossary.md`。 |
+| `--docs` | array | 要翻译的文档路径列表。可以多次指定。 |
+| `--langs` | array | 目标语言代码列表（例如 `zh-CN`、`ja`）。可以多次指定。 |
+| `--feedback` | string | 提供反馈以提高翻译质量。 |
+| `--glossary` | string | 词汇表文件的路径，以确保跨语言术语的一致性。使用 `@path/to/glossary.md`。 |
 
-### 使用示例
+### 用法示例
 
 **启动交互式翻译会话：**
 
@@ -158,28 +217,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.md --docs /overview.md
 ```
 
-**使用术语表和反馈进行翻译以获得更好的质量：**
+**使用词汇表和反馈进行翻译以提高质量：**
 
 ```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) 实例。
 
 ### 选项
 
-| 选项     | 类型   | 描述                                                                                          |
+| 选项 | 类型 | 描述 |
 | ---------- | ------ | ---------------------------------------------------------------------------------------------------- |
 | `--appUrl` | string | 您自托管的 Discuss Kit 实例的 URL。如果未提供，该命令将以交互方式运行。 |
 
-### 使用示例
+### 用法示例
 
 **启动交互式发布会话：**
 
@@ -195,16 +254,28 @@ aigne doc publish --appUrl https://your-discuss-kit-instance.com
 
 ---
 
-## `aigne doc init`
+## `aigne doc prefs`
 
-手动启动交互式配置向导。这对于设置新项目或修改现有项目的配置非常有用。该向导会引导您定义源代码路径、设置输出目录、选择语言以及定义文档的风格和目标受众。
+显示项目的当前配置设置。这是一个只读命令，可帮助您验证在 `init` 或 `generate` 过程中应用的设置。
 
-### 使用示例
+### 用法示例
 
-**启动设置向导：**
+**查看当前项目配置：**
 
 ```bash
-aigne doc init
+aigne doc prefs
 ```
 
-有关如何根据您的需求定制 DocSmith 的更多详细信息，请参阅[配置指南](./configuration.md)。
+---
+
+## `aigne doc clear`
+
+启动一个交互式会话以清除本地存储的数据。这可用于删除生成的文档、文档结构配置或缓存的身份验证令牌。
+
+### 用法示例
+
+**启动交互式清理过程：**
+
+```bash
+aigne doc clear
+```

package/docs/configuration-interactive-setup.md

@@ -79,7 +79,7 @@ As you make selections, the wizard provides defaults and filters subsequent opti
 
 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.

package/docs/configuration-language-support.md

@@ -1,6 +1,6 @@
 # Language Support
 
-AIGNE DocSmith uses AI to provide automated documentation translation into 12 languages. This allows you to generate and maintain documentation for a global audience using the `aigne doc translate` command.
+AIGNE DocSmith uses AI to provide automated documentation translation into 12 languages. Generate and maintain documentation for a global audience using the `aigne doc translate` command.
 
 The translation workflow processes your source documents through an AI engine to generate localized versions in your selected target languages.
 

package/docs/configuration-preferences.md

@@ -66,7 +66,7 @@ Each rule saved in `preferences.yml` has the following structure:
 
 ## Managing Preferences with the CLI
 
-You can view and manage all your saved preferences using the `aigne doc prefs` command. This allows you to list, activate, deactivate, or permanently remove rules.
+View and manage all your saved preferences using the `aigne doc prefs` command. You can list, activate, deactivate, or permanently remove rules.
 
 ### Listing All Preferences