@aigne/doc-smith 0.8.12-beta.3 → 0.8.12-beta.5

package/docs/getting-started.ja.md

@@ -1,120 +1,88 @@
 # はじめに
 
-このガイドでは、AIGNE DocSmith をインストールし、プロジェクトを設定し、ソースコードから完全なドキュメント一式を数分で生成するための手順をステップバイステップで説明します。
+このガイドでは、AIGNE DocSmithをインストールし、最初のドキュメントセットを生成するためのステップバイステップの手順を説明します。このプロセスは分かりやすく設計されており、短時間で完了できます。
 
-## ステップ1：前提条件
+## 前提条件
 
-始める前に、お使いのシステムに Node.js バージョン 20 以降がインストールされていることを確認してください。DocSmith は Node.js 環境で動作するコマンドラインツールです。インストールには、Node.js に付属している Node Package Manager (npm) の使用を推奨します。
+インストールを進める前に、お使いのシステムが以下の要件を満たしていることを確認してください。
 
-詳細なインストール手順については、公式の [Node.js ウェブサイト](https://nodejs.org/) を参照してください。一般的なオペレーティングシステム向けの簡単なガイドを以下に示します。
+*   **Node.js**: バージョン20以降が必要です。DocSmithはNode.jsのインストールに含まれているNode Package Manager (npm) を使用してインストールされます。Node.jsをインストールするには、公式の[Node.jsウェブサイト](https://nodejs.org/)にアクセスし、お使いのオペレーティングシステムの手順に従ってください。ターミナルを開き、`node -v`と`npm -v`を実行することでインストールを確認できます。
 
-**Windows**
-1.  [Node.js ダウンロードページ](https://nodejs.org/en/download) から Windows インストーラー (`.msi`) をダウンロードします。
-2.  インストーラーを実行し、セットアップウィザードの指示に従います。
+*   **APIキー**: 開始にあたりAPIキーは不要です。デフォルトでは、DocSmithはAIによる生成のためにAIGNE Hubサービスを使用します。これにより、直接的な設定なしで様々な大規模言語モデルを利用できます。
 
-**macOS**
+## インストール
 
-macOS のパッケージマネージャーである [Homebrew](https://brew.sh/) を使用したインストール方法を推奨します。
+このツールは、AIGNEコマンドラインインターフェース(CLI)の一部として配布されています。
 
-```bash Terminal icon=lucide:apple
-# Homebrew がまだインストールされていない場合はインストールします
-/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+### ステップ1：AIGNE CLIをインストールする
 
-# Node.js をインストールします
-brew install node
-```
-
-または、[Node.js ウェブサイト](https://nodejs.org/) から直接 macOS インストーラー (`.pkg`) をダウンロードすることもできます。
-
-**Linux**
+システムにAIGNE CLIをグローバルにインストールするには、ターミナルで以下のコマンドを実行します。
 
-Debian および Ubuntu ベースのディストリビューションでは、次のコマンドを使用します。
-
-```bash Terminal icon=lucide:laptop
-sudo apt-get update
-sudo apt-get install -y ca-certificates curl gnupg
-curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
-sudo apt-get install -y nodejs
+```bash title="AIGNE CLIのインストール" icon=logos:npm-icon
+npm install -g @aigne/cli
 ```
 
-Red Hat、CentOS、および Fedora では、次のコマンドを使用します。
+このコマンドはパッケージをダウンロードしてインストールし、どのディレクトリからでも`aigne`コマンドを利用できるようにします。
 
-```bash Terminal icon=lucide:laptop
-curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
-sudo yum install nodejs
-```
-
-### インストールの確認
+### ステップ2：インストールを確認する
 
-インストールが完了したら、ターミナルを開き、次のコマンドを実行して Node.js と npm が正しくインストールされていることを確認します。
+インストールが完了したら、ドキュメンテーションツールのヘルプコマンドを実行して確認します。
 
-```bash Terminal
-node --version
-npm --version
+```bash title="インストールの確認"
+aigne doc --help
 ```
 
-## ステップ2：AIGNE CLI のインストール
+このコマンドにより、利用可能なDocSmithのコマンドとオプションのリストが表示され、インストールが成功したことを確認できます。
 
-DocSmith ツールは、公式の AIGNE コマンドラインインターフェース (CLI) の一部として配布されています。npm を使用して、システムに CLI をグローバルにインストールします。
+## 最初のドキュメントを生成する
 
-```bash Terminal icon=logos:npm
-npm install -g @aigne/cli
-```
+以下の手順に従って、プロジェクトを分析し、完全なドキュメントセットを生成します。
 
-インストールが完了したら、ヘルプコマンドを実行して DocSmith が利用可能であることを確認します。
+### ステップ1：プロジェクトディレクトリに移動する
 
-```bash Terminal
-aigne doc --help
-```
+ターミナルを開き、`cd`コマンドを使用して、ドキュメントを作成したいプロジェクトのルートにカレントディレクトリを変更します。
 
-このコマンドを実行すると、DocSmith のヘルプメニューが表示され、インストールが完了し、使用できる状態であることが確認できます。
+```bash title="ディレクトリの変更" icon=mdi:folder-open
+cd /path/to/your/project
+```
 
-## ステップ3：ドキュメントの生成
+### ステップ2：生成コマンドを実行する
 
-AIGNE CLI をインストールしたら、ドキュメントを生成できます。ターミナルでプロジェクトのルートディレクトリに移動し、次のコマンドを実行します。
+主要な`generate`コマンドを実行します。この単一のコマンドが、ドキュメント作成プロセス全体を処理します。
 
-```bash Terminal icon=lucide:sparkles
+```bash title="生成コマンドの実行"
 aigne doc generate
 ```
 
-![generate コマンドを実行すると、プロセスが開始され、インテリジェントなセットアップウィザードがトリガーされます。](../assets/screenshots/doc-generate.png)
-
-### 自動設定
-
-新しいプロジェクトでこのコマンドを初めて実行すると、DocSmith は設定ファイルが存在しないことを検出し、プロセスをガイドするための対話型のセットアップウィザードを自動的に起動します。
+### ステップ3：対話式セットアップを完了する
 
-ウィザードでは、ドキュメントの特性を定義するための一連の質問が表示されます。これには以下が含まれます。
+プロジェクトで初めて`generate`コマンドを実行すると、DocSmithは1回限りの対話式セットアッププロセスを開始します。ドキュメントの主な目的、対象読者、言語など、ドキュメントの設定に関する一連の質問が表示されます。設定を保存するために、`.aigne/doc-smith`ディレクトリに`config.yaml`ファイルが作成されます。
 
-*   主な目的とライティングスタイル。
-*   対象読者（例：開発者、エンドユーザー）。
-*   主要言語と翻訳用の追加言語。
-*   AI が分析するソースコードのパス。
-*   生成されたドキュメントファイルの出力ディレクトリ。
+### ステップ4：生成を待つ
 
-![一連の質問に答えて、プロジェクトのセットアップを完了します。](../assets/screenshots/doc-complete-setup.png)
+セットアップが完了すると、DocSmithは自動的に以下のアクションを実行します。
 
-プロンプトに回答すると、DocSmith は選択内容を設定ファイルに保存し、コードベースの分析を開始し、ドキュメント構造を計画し、コンテンツを生成します。
+1.  **コードベースの分析**: ソースファイルをスキャンして、プロジェクトの構造とロジックを理解します。
+2.  **構造の計画**: セクションやトピックを含む、ドキュメントの論理的な計画を作成します。
+3.  **コンテンツの生成**: 分析と設定に基づいてドキュメントのコンテンツを記述します。
 
-![DocSmith がドキュメント構造を計画し、ファイルの生成を開始します。](../assets/screenshots/doc-generate-docs.png)
-
-## ステップ4：出力の確認
-
-生成プロセスが完了すると、ターミナルに確認メッセージが表示され、ドキュメントが正常に作成されたことが示されます。新しいドキュメントは、セットアップ時に指定した出力ディレクトリにあります。デフォルト設定を使用した場合は、`.aigne/doc-smith/docs` にあります。
-
-![確認メッセージは、ドキュメントが正常に生成されたことを示します。](../assets/screenshots/doc-generated-successfully.png)
+完了すると確認メッセージが表示され、生成されたファイルはセットアップ時に指定された出力ディレクトリ（例：`.aigne/doc-smith/docs`）に配置されます。
 
 ## 次のステップ
 
-最初のドキュメント一式が正常に生成されました。これで、より高度な機能やカスタマイズオプションを試す準備が整いました。
+最初のドキュメントセットの生成が成功しました。ドキュメントを管理し、強化するための一般的な次のステップは以下の通りです。
 
-<x-cards>
-  <x-card data-title="コア機能" data-icon="lucide:box" data-href="/features">
-    ドキュメントの更新からオンラインでの公開まで、主要なコマンドと機能について学びます。
+<x-cards data-columns="2">
+  <x-card data-title="ドキュメントの更新" data-icon="lucide:refresh-cw" data-href="/guides/updating-documentation">
+    コードの変更や新しい要件に基づいて、ドキュメントの特定の部分を修正または再生成します。
+  </x-card>
+  <x-card data-title="ドキュメントの翻訳" data-icon="lucide:languages" data-href="/guides/translating-documentation">
+    ドキュメントを中国語、スペイン語、ドイツ語など、サポートされている12言語のいずれかに翻訳します。
   </x-card>
-  <x-card data-title="設定ガイド" data-icon="lucide:settings" data-href="/configuration">
-    設定ファイルを編集して、ドキュメントのスタイル、対象読者、言語を微調整する方法を学びます。
+  <x-card data-title="ドキュメントの公開" data-icon="lucide:rocket" data-href="/guides/publishing-your-docs">
+    ドキュメントをオンラインで公開し、チームや一般の人が利用できるようにします。
   </x-card>
-  <x-card data-title="CLI コマンドリファレンス" data-icon="lucide:terminal" data-href="/cli-reference">
-    利用可能なすべての `aigne doc` コマンドとそのオプションの完全なリファレンスを取得します。
+  <x-card data-title="設定の確認" data-icon="lucide:settings" data-href="/configuration/initial-setup">
+    初期セットアップ時に作成されたconfig.yamlファイルを確認・修正して、設定を調整します。
   </x-card>
 </x-cards>

package/docs/getting-started.md

@@ -1,120 +1,88 @@
 # Getting Started
 
-This guide provides a step-by-step walkthrough to install AIGNE DocSmith, configure a project, and generate a complete set of documentation from your source code in minutes.
+This guide provides a step-by-step procedure for installing AIGNE DocSmith and generating your first set of documentation. The process is designed to be straightforward and can be completed quickly.
 
-## Step 1: Prerequisites
+## Prerequisites
 
-Before you begin, ensure you have Node.js version 20 or higher installed on your system. DocSmith is a command-line tool that operates within the Node.js environment. We recommend using the Node Package Manager (npm), which is included with Node.js, for installation.
+Before proceeding with the installation, ensure your system meets the following requirements:
 
-For detailed installation instructions, please refer to the official [Node.js website](https://nodejs.org/). A brief guide for common operating systems is provided below.
+*   **Node.js**: Version 20 or newer is required. DocSmith is installed using the Node Package Manager (npm), which is included with the Node.js installation. To install Node.js, visit the official [Node.js website](https://nodejs.org/) and follow the instructions for your operating system. You can verify the installation by opening your terminal and running `node -v` and `npm -v`.
 
-**Windows**
-1.  Download the Windows Installer (`.msi`) from the [Node.js downloads page](https://nodejs.org/en/download).
-2.  Execute the installer and follow the prompts in the setup wizard.
+*   **API Keys**: No API keys are required to start. By default, DocSmith uses the AIGNE Hub service for AI-powered generation, which allows you to use various large language models without direct configuration.
 
-**macOS**
+## Installation
 
-The recommended installation method is using [Homebrew](https://brew.sh/), a package manager for macOS.
+The tool is distributed as part of the AIGNE command-line interface (CLI).
 
-```bash Terminal icon=lucide:apple
-# Install Homebrew if it is not already installed
-/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+### Step 1: Install the AIGNE CLI
 
-# Install Node.js
-brew install node
-```
-
-Alternatively, you can download the macOS Installer (`.pkg`) directly from the [Node.js website](https://nodejs.org/).
-
-**Linux**
+To install the AIGNE CLI globally on your system, execute the following command in your terminal:
 
-For Debian and Ubuntu-based distributions, use the following commands:
-
-```bash Terminal icon=lucide:laptop
-sudo apt-get update
-sudo apt-get install -y ca-certificates curl gnupg
-curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
-sudo apt-get install -y nodejs
+```bash title="Install AIGNE CLI" icon=logos:npm-icon
+npm install -g @aigne/cli
 ```
 
-For Red Hat, CentOS, and Fedora, use the following commands:
+This command downloads and installs the package, making the `aigne` command available from any directory.
 
-```bash Terminal icon=lucide:laptop
-curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
-sudo yum install nodejs
-```
-
-### Verify Installation
+### Step 2: Verify the Installation
 
-After the installation is complete, open your terminal and run the following commands to confirm that Node.js and npm are correctly installed:
+After the installation is complete, verify it by running the help command for the documentation tool:
 
-```bash Terminal
-node --version
-npm --version
+```bash title="Verify Installation"
+aigne doc --help
 ```
 
-## Step 2: Install AIGNE CLI
+This command should display a list of available DocSmith commands and options, confirming that the installation was successful.
 
-The DocSmith tool is distributed as part of the official AIGNE Command Line Interface (CLI). Install the CLI globally on your system using npm:
+## Generating Your First Documents
 
-```bash Terminal icon=logos:npm
-npm install -g @aigne/cli
-```
+Follow these steps to analyze your project and generate a complete set of documentation.
 
-Once the installation is finished, verify that DocSmith is available by running its help command:
+### Step 1: Navigate to Your Project Directory
 
-```bash Terminal
-aigne doc --help
-```
+Open your terminal and use the `cd` command to change the current directory to the root of the project you wish to document.
 
-This command should display the help menu for DocSmith, confirming that it is installed and ready to use.
+```bash title="Change Directory" icon=mdi:folder-open
+cd /path/to/your/project
+```
 
-## Step 3: Generate Your Documentation
+### Step 2: Run the Generate Command
 
-With the AIGNE CLI installed, you can now generate your documentation. Navigate to the root directory of your project in your terminal and execute the following command:
+Execute the primary `generate` command. This single command handles the entire documentation creation process.
 
-```bash Terminal icon=lucide:sparkles
+```bash title="Run Generate Command"
 aigne doc generate
 ```
 
-![Running the generate command initiates the process and triggers an intelligent setup wizard.](../assets/screenshots/doc-generate.png)
-
-### Automatic Configuration
-
-The first time you run this command in a new project, DocSmith will detect that no configuration file exists and will automatically launch an interactive setup wizard to guide you through the process.
+### Step 3: Complete the Interactive Setup
 
-The wizard will ask a series of questions to define the characteristics of your documentation, including:
+The first time you run the `generate` command in a project, DocSmith will initiate a one-time interactive setup process. You will be asked a series of questions to configure your documentation preferences, such as its primary purpose, target audience, and language. A `config.yaml` file will be created in the `.aigne/doc-smith` directory to store your settings.
 
-*   The primary purpose and writing style.
-*   The intended target audience (e.g., developers, end-users).
-*   The primary language and any additional languages for translation.
-*   The source code paths for the AI to analyze.
-*   The output directory for the generated document files.
+### Step 4: Await Generation
 
-![Answer a series of questions to complete the project setup.](../assets/screenshots/doc-complete-setup.png)
+Once the setup is complete, DocSmith will perform the following actions automatically:
 
-After you answer the prompts, DocSmith will save your choices to a configuration file, begin analyzing your codebase, plan the document structure, and generate the content.
+1.  **Analyze Codebase**: It scans your source files to understand the project's structure and logic.
+2.  **Plan Structure**: It creates a logical plan for the documentation, including sections and topics.
+3.  **Generate Content**: It writes the documentation content based on the analysis and your configuration.
 
-![DocSmith will plan the document structure and begin generating the files.](../assets/screenshots/doc-generate-docs.png)
-
-## Step 4: Review Your Output
-
-When the generation process is complete, a confirmation message will appear in your terminal, indicating the successful creation of your documents. Your new documentation is now located in the output directory you specified during setup. If you used the default setting, you can find it at `.aigne/doc-smith/docs`.
-
-![A confirmation message indicates that the documentation has been generated successfully.](../assets/screenshots/doc-generated-successfully.png)
+Upon completion, a confirmation message will appear, and the generated files will be located in the output directory specified during setup (e.g., `.aigne/doc-smith/docs`).
 
 ## What's Next?
 
-You have successfully generated your first set of documents. Now you are ready to explore more advanced features and customization options.
+You have successfully generated your first set of documents. Here are the common next steps to manage and enhance your documentation:
 
-<x-cards>
-  <x-card data-title="Core Features" data-icon="lucide:box" data-href="/features">
-    Explore the main commands and capabilities, from updating documents to publishing them online.
+<x-cards data-columns="2">
+  <x-card data-title="Update Documentation" data-icon="lucide:refresh-cw" data-href="/guides/updating-documentation">
+    Modify or regenerate specific sections of your documentation based on code changes or new requirements.
+  </x-card>
+  <x-card data-title="Translate Documentation" data-icon="lucide:languages" data-href="/guides/translating-documentation">
+    Translate your documents into any of the 12 supported languages, such as Chinese, Spanish, or German.
   </x-card>
-  <x-card data-title="Configuration Guide" data-icon="lucide:settings" data-href="/configuration">
-    Learn how to fine-tune your documentation's style, audience, and languages by editing the configuration file.
+  <x-card data-title="Publish Your Docs" data-icon="lucide:rocket" data-href="/guides/publishing-your-docs">
+    Make your documentation available online for your team or the public.
   </x-card>
-  <x-card data-title="CLI Command Reference" data-icon="lucide:terminal" data-href="/cli-reference">
-    Get a complete reference for all available `aigne doc` commands and their options.
+  <x-card data-title="Review Configuration" data-icon="lucide:settings" data-href="/configuration/initial-setup">
+    Review and modify the config.yaml file that was created during the initial setup to adjust your preferences.
   </x-card>
 </x-cards>

package/docs/getting-started.zh-TW.md

@@ -1,120 +1,88 @@
 # 開始使用
 
-本指南提供逐步教學，引導您安裝 AIGNE DocSmith、設定專案，並在幾分鐘內從您的原始碼產生一套完整的文件。
+本指南提供安裝 AIGNE DocSmith 並產生第一份文件的逐步流程。整個過程設計得簡單明瞭，可以快速完成。
 
-## 步驟 1：前置準備
+## 前提條件
 
-在開始之前，請確保您的系統上已安裝 Node.js 20 或更高版本。DocSmith 是一個在 Node.js 環境中運作的命令列工具。我們建議使用 Node.js 隨附的 Node Package Manager (npm) 進行安裝。
+在進行安裝之前，請確保您的系統符合以下要求：
 
-關於詳細的安裝說明，請參考官方的 [Node.js 網站](https://nodejs.org/)。以下為常見作業系統的簡要指南。
+*   **Node.js**：需要 20 或更新版本。DocSmith 使用 Node Package Manager (npm) 安裝，npm 包含在 Node.js 的安裝中。若要安裝 Node.js，請造訪官方 [Node.js 網站](https://nodejs.org/) 並按照您作業系統的說明進行操作。您可以透過開啟終端機並執行 `node -v` 和 `npm -v` 來驗證安裝。
 
-**Windows**
-1.  從 [Node.js 下載頁面](https://nodejs.org/en/download) 下載 Windows 安裝程式 (`.msi`)。
-2.  執行安裝程式並依照設定精靈中的提示操作。
+*   **API 金鑰**：開始時不需要任何 API 金鑰。預設情況下，DocSmith 使用 AIGNE Hub 服務進行 AI 驅動的生成，讓您無需直接設定即可使用各種大型語言模型。
 
-**macOS**
+## 安裝
 
-建議的安裝方法是使用 [Homebrew](https://brew.sh/)，這是一款適用於 macOS 的套件管理器。
+此工具作為 AIGNE 命令列介面 (CLI) 的一部分進行分發。
 
-```bash Terminal icon=lucide:apple
-# 如果尚未安裝 Homebrew，請先安裝
-/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
+### 步驟 1：安裝 AIGNE CLI
 
-# 安裝 Node.js
-brew install node
-```
-
-或者，您也可以直接從 [Node.js 網站](https://nodejs.org/) 下載 macOS 安裝程式 (`.pkg`)。
-
-**Linux**
+若要在您的系統上全域安裝 AIGNE CLI，請在終端機中執行以下指令：
 
-對於 Debian 和基於 Ubuntu 的發行版，請使用以下指令：
-
-```bash Terminal icon=lucide:laptop
-sudo apt-get update
-sudo apt-get install -y ca-certificates curl gnupg
-curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
-sudo apt-get install -y nodejs
+```bash title="安裝 AIGNE CLI" icon=logos:npm-icon
+npm install -g @aigne/cli
 ```
 
-對於 Red Hat、CentOS 和 Fedora，請使用以下指令：
-
-```bash Terminal icon=lucide:laptop
-curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
-sudo yum install nodejs
-```
+此指令會下載並安裝套件，使 `aigne` 指令在任何目錄下都可用。
 
-### 驗證安裝
+### 步驟 2：驗證安裝
 
-安裝完成後，開啟您的終端機並執行以下指令，以確認 Node.js 和 npm 已正確安裝：
+安裝完成後，請執行文件工具的說明指令來進行驗證：
 
-```bash Terminal
-node --version
-npm --version
+```bash title="驗證安裝"
+aigne doc --help
 ```
 
-## 步驟 2：安裝 AIGNE CLI
+此指令應會顯示可用的 DocSmith 指令與選項列表，確認安裝成功。
 
-DocSmith 工具是作為官方 AIGNE 命令列介面 (CLI) 的一部分發行的。請使用 npm 在您的系統上全域安裝 CLI：
+## 產生您的第一份文件
 
-```bash Terminal icon=logos:npm
-npm install -g @aigne/cli
-```
+請依照以下步驟分析您的專案並產生一套完整的文件。
 
-安裝完成後，執行其幫助指令來驗證 DocSmith 是否可用：
+### 步驟 1：導覽至您的專案目錄
 
-```bash Terminal
-aigne doc --help
-```
+開啟您的終端機，並使用 `cd` 指令將目前目錄切換到您想要建立文件的專案根目錄。
 
-此指令應顯示 DocSmith 的幫助選單，確認其已安裝並可供使用。
+```bash title="切換目錄" icon=mdi:folder-open
+cd /path/to/your/project
+```
 
-## 步驟 3：產生您的文件
+### 步驟 2：執行產生指令
 
-安裝 AIGNE CLI 後，您現在可以產生您的文件了。在您的終端機中，導覽至專案的根目錄並執行以下指令：
+執行主要的 `generate` 指令。這個單一指令會處理整個文件建立過程。
 
-```bash Terminal icon=lucide:sparkles
+```bash title="執行產生指令"
 aigne doc generate
 ```
 
+### 步驟 3：完成互動式設定
 
+當您第一次在專案中執行 `generate` 指令時，DocSmith 將啟動一次性的互動式設定流程。系統會詢問您一系列問題來設定您的文件偏好，例如其主要目的、目標受眾和語言。設定完成後，將會在 `.aigne/doc-smith` 目錄中建立一個 `config.yaml` 檔案來儲存您的設定。
 
-### 自動設定
-
-當您首次在新專案中執行此指令時，DocSmith 會偵測到沒有設定檔存在，並會自動啟動一個互動式設定精靈來引導您完成整個過程。
-
-該精靈會詢問一系列問題來定義您文件的特性，包括：
-
-*   主要目的與寫作風格。
-*   預期的目標受眾（例如，開發者、終端使用者）。
-*   主要語言以及任何用於翻譯的其他語言。
-*   供 AI 分析的原始碼路徑。
-*   產生文件檔案的輸出目錄。
-
-
+### 步驟 4：等待產生
 
-在您回答完提示後，DocSmith 會將您的選擇儲存到一個設定檔中，開始分析您的程式碼庫、規劃文件結構，並產生內容。
+設定完成後，DocSmith 將自動執行以下操作：
 
+1.  **分析程式碼庫**：掃描您的原始檔案以了解專案的結構和邏輯。
+2.  **規劃結構**：為文件建立一個邏輯計畫，包含章節和主題。
+3.  **產生內容**：根據分析和您的設定撰寫文件內容。
 
+完成後，將會出現一則確認訊息，且產生的檔案將位於設定時指定的輸出目錄中（例如 `.aigne/doc-smith/docs`）。
 
-## 步驟 4：檢視您的產出
+## 接下來呢？
 
-當產生過程完成後，您的終端機中會出現一則確認訊息，表示您的文件已成功建立。您的新文件現在位於您在設定過程中指定的輸出目錄中。如果您使用預設設定，可以在 `.aigne/doc-smith/docs` 中找到它。
+您已成功產生第一份文件。以下是管理和強化文件的常見後續步驟：
 
-
-
-## 下一步？
-
-您已成功產生第一套文件。現在，您可以開始探索更進階的功能和自訂選項。
-
-<x-cards>
-  <x-card data-title="核心功能" data-icon="lucide:box" data-href="/features">
-    探索主要指令與功能，從更新文件到線上發佈。
+<x-cards data-columns="2">
+  <x-card data-title="更新文件" data-icon="lucide:refresh-cw" data-href="/guides/updating-documentation">
+    根據程式碼變更或新需求，修改或重新產生文件的特定部分。
+  </x-card>
+  <x-card data-title="翻譯文件" data-icon="lucide:languages" data-href="/guides/translating-documentation">
+    將您的文件翻譯成 12 種支援的語言之一，例如中文、西班牙文或德文。
   </x-card>
-  <x-card data-title="設定指南" data-icon="lucide:settings" data-href="/configuration">
-    學習如何透過編輯設定檔來微調文件的風格、受眾和語言。
+  <x-card data-title="發布您的文件" data-icon="lucide:rocket" data-href="/guides/publishing-your-docs">
+    將您的文件發布到網路上，供您的團隊或大眾使用。
   </x-card>
-  <x-card data-title="CLI 指令參考" data-icon="lucide:terminal" data-href="/cli-reference">
-    取得所有可用 `aigne doc` 指令及其選項的完整參考。
+  <x-card data-title="檢視設定" data-icon="lucide:settings" data-href="/configuration/initial-setup">
+    檢視並修改在初始設定期間建立的 config.yaml 檔案，以調整您的偏好設定。
   </x-card>
 </x-cards>