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

package/.aigne/doc-smith/config.yaml

@@ -66,7 +66,7 @@ translateLanguages:
 docsDir: ./docs  # Directory to save generated documentation
 sourcesPath:  # Source code paths to analyze
   - ./
-lastGitHead: f3f14b93e6b2e6beb42b2f368c2560ab050dfd03
+lastGitHead: 6fc5d715e778663896ae179975ec72d9e5ff97ed
 # ⚠️ Warning: boardId is auto-generated by system, please do not edit manually
 boardId: "docsmith"
 appUrl: https://docsmith.aigne.io

package/.release-please-manifest.json

@@ -1,3 +1,3 @@
 {
-  ".": "0.8.11-beta.5"
+  ".": "0.8.11-beta.6"
 }

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## [0.8.11-beta.6](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.8.11-beta.5...v0.8.11-beta.6) (2025-10-02)
+
+
+### Miscellaneous Chores
+
+* release 0.8.11-beta.6 ([ecc8f5c](https://github.com/AIGNE-io/aigne-doc-smith/commit/ecc8f5c4ff9cc813e5cf7e35cbfdb915826cd183))
+
 ## [0.8.11-beta.5](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.8.11-beta.4...v0.8.11-beta.5) (2025-10-01)
 
 
@@ -79,7 +86,7 @@
 ### Bug Fixes
 
 * polish code test ([#122](https://github.com/AIGNE-io/aigne-doc-smith/issues/122)) ([0629705](https://github.com/AIGNE-io/aigne-doc-smith/commit/0629705ebd271282411d507421c1ba5dd01473b9))
-* update document structure review prompts and display ([#119](https://github.com/AIGNE-io/aigne-doc-smith/issues/119)) ([e2d99db](https://github.com/AIGNE-io/aigne-doc-smith/commit/e2d99db83ff3a6266b32dd450a79b6e000aff09e))
+* update documentation structure review prompts and display ([#119](https://github.com/AIGNE-io/aigne-doc-smith/issues/119)) ([e2d99db](https://github.com/AIGNE-io/aigne-doc-smith/commit/e2d99db83ff3a6266b32dd450a79b6e000aff09e))
 * update usage rules for field elements ([#120](https://github.com/AIGNE-io/aigne-doc-smith/issues/120)) ([434f161](https://github.com/AIGNE-io/aigne-doc-smith/commit/434f161ab7dd989d57ca670f36d0828c09abe38a))
 
 ## [0.8.10-beta.1](https://github.com/AIGNE-io/aigne-doc-smith/compare/v0.8.10-beta...v0.8.10-beta.1) (2025-09-18)
@@ -87,7 +94,7 @@
 
 ### Features
 
-* support document structure review workflow ([#117](https://github.com/AIGNE-io/aigne-doc-smith/issues/117)) ([ec7ae80](https://github.com/AIGNE-io/aigne-doc-smith/commit/ec7ae80b26a1b66928bddef7ac401f633a0f5a2b))
+* support documentation structure review workflow ([#117](https://github.com/AIGNE-io/aigne-doc-smith/issues/117)) ([ec7ae80](https://github.com/AIGNE-io/aigne-doc-smith/commit/ec7ae80b26a1b66928bddef7ac401f633a0f5a2b))
 
 
 ### Bug Fixes

package/README.md

@@ -45,7 +45,7 @@ As shown in the diagram, DocSmith integrates seamlessly with other [AIGNE](https
 
 - **AIGNE Hub Integration**: Use [AIGNE Hub](https://www.aigne.io/en/hub) without API keys, switch between Google Gemini, OpenAI GPT, Claude, and more
 - **Multiple LLM Support**: Bring your own API keys for OpenAI, Anthropic, Google, and other providers
-- **Discuss Kit Publishing**: Deploy to [docsmith.aigne.io](https://docsmith.aigne.io/app/) or your own [Discuss Kit](https://www.web3kit.rocks/discuss-kit) instance
+- **One-Click Publishing**: Make your docs live and generate shareable links for your team - publish to [docsmith.aigne.io](https://docsmith.aigne.io/app/) or your own [Discuss Kit](https://www.web3kit.rocks/discuss-kit) instance
 
 ### 🔄 Smart Updates
 

package/agents/clear/choose-contents.mjs

@@ -5,8 +5,8 @@ const TARGET_METADATA = {
     agent: "clearGeneratedDocs",
   },
   documentStructure: {
-    label: "document structure",
-    description: "Delete the document structure and all generated documents.",
+    label: "documentation structure",
+    description: "Delete the documentation structure and all generated documents.",
     agent: "clearDocumentStructure",
   },
   documentConfig: {

package/agents/clear/clear-document-structure.mjs

@@ -20,8 +20,8 @@ export default async function clearDocumentStructure(input = {}, _options = {})
 
     const structureDisplayPath = toDisplayPath(structurePlanPath);
     const structureMessage = structureExists
-      ? `Cleared document structure plan (${structureDisplayPath})`
-      : `Document structure plan already empty (${structureDisplayPath})`;
+      ? `Cleared documentation structure (${structureDisplayPath})`
+      : `Documentation structure already empty (${structureDisplayPath})`;
 
     results.push({
       type: "structure",
@@ -33,7 +33,7 @@ export default async function clearDocumentStructure(input = {}, _options = {})
     results.push({
       type: "structure",
       error: true,
-      message: `Failed to clear document structure plan: ${error.message}`,
+      message: `Failed to clear documentation structure: ${error.message}`,
     });
   }
 
@@ -69,11 +69,11 @@ export default async function clearDocumentStructure(input = {}, _options = {})
 
   let header;
   if (errorItems > 0) {
-    header = "Document structure cleanup finished with some issues.";
+    header = "Documentation Structure cleanup finished with some issues.";
   } else if (clearedItems > 0) {
-    header = "Document structure cleared successfully!";
+    header = "Documentation Structure cleared successfully!";
   } else {
-    header = "Document structure already empty.";
+    header = "Documentation Structure already empty.";
   }
 
   const detailLines = results.map((item) => `- ${item.message}`).join("\n");
@@ -101,6 +101,6 @@ clearDocumentStructure.input_schema = {
   },
 };
 
-clearDocumentStructure.taskTitle = "Clear document structure and all generated documents";
+clearDocumentStructure.taskTitle = "Clear documentation structure and all generated documents";
 clearDocumentStructure.description =
-  "Clear the document structure plan (structure-plan.json) and optionally the documents directory";
+  "Clear the documentation structure (structure-plan.json) and optionally the documents directory";

package/agents/clear/index.yaml

@@ -2,7 +2,7 @@ type: team
 name: clear
 alias:
   - clear
-description: Clear various types of data including document structure, generated documents, configuration, and authorization tokens
+description: Clear various types of data including documentation structure, generated documents, configuration, and authorization tokens
 skills:
   - url: ../init/index.mjs
     default_input:

package/agents/evaluate/document-structure.yaml

@@ -11,7 +11,7 @@ input_schema:
   properties:
     documentStructureYaml:
       type: string
-      description: Document structure planning
+      description: Documentation structure data
     purposes:
       type: string
       description: User-selected document goals

package/agents/generate/check-document-structure.yaml

@@ -1,5 +1,5 @@
 name: checkDocumentStructure
-description: Check the Document Structure to ensure it meets expectations, especially in scenarios with previous generation results and user feedback.
+description: Check the Documentation Structure to ensure it meets expectations, especially in scenarios with previous generation results and user feedback.
 instructions:
   url: ../../prompts/structure/check-document-structure.md
 input_schema:
@@ -7,10 +7,10 @@ input_schema:
   properties:
     documentStructure:
       $ref: ../schema/document-structure.yaml
-      description: Newly generated document structure.
+      description: Newly generated documentation structure.
     originalDocumentStructure:
       $ref: ../schema/document-structure.yaml
-      description: Previous generation's document structure for comparison. If it doesn't exist, the check passes by default.
+      description: Previous generation's documentation structure for comparison. If it doesn't exist, the check passes by default.
     feedback:
       type: string
       description: User feedback provided for the previous generation's results.

package/agents/generate/check-need-generate-structure.mjs

@@ -18,10 +18,10 @@ export default async function checkNeedGenerateStructure(
   if (!originalDocumentStructure) {
     const choice = await options.prompts.select({
       message:
-        "Your project configuration is complete. Would you like to generate the document structure now?",
+        "Your project configuration is complete. Would you like to generate the documentation structure now?",
       choices: [
         {
-          name: "Generate now - Start generating the document structure",
+          name: "Generate now - Start generating the documentation structure",
           value: "generate",
         },
         {
@@ -49,7 +49,7 @@ export default async function checkNeedGenerateStructure(
     }
   }
 
-  // Check if we need to regenerate document structure
+  // Check if we need to regenerate documentation structure
   let shouldRegenerate = false;
   let finalFeedback = feedback;
 
@@ -82,7 +82,7 @@ export default async function checkNeedGenerateStructure(
       finalFeedback = `
       ${finalFeedback || ""}
 
-      Update document structure based on the latest DataSources:
+      Update documentation structure based on the latest DataSources:
         1. For new content, add new sections as needed or supplement existing section displays
         2. Be cautious when deleting sections, unless all associated sourceIds have been removed
         3. Do not modify the path of existing sections
@@ -97,11 +97,11 @@ export default async function checkNeedGenerateStructure(
     finalFeedback = `
     ${finalFeedback || ""}
 
-    User requested forced regeneration of document structure. Please regenerate based on the latest Data Sources and user requirements, **allowing any modifications**.
+    User requested forced regeneration of documentation structure. Please regenerate based on the latest Data Sources and user requirements, **allowing any modifications**.
     `;
   }
 
-  // If no regeneration needed, return original document structure
+  // If no regeneration needed, return original documentation structure
   if (originalDocumentStructure && !finalFeedback && !shouldRegenerate) {
     return {
       documentStructure: originalDocumentStructure,
@@ -110,7 +110,7 @@ export default async function checkNeedGenerateStructure(
 
   const planningAgent = options.context.agents["refineDocumentStructure"];
 
-  // Get user preferences for document structure and global scope
+  // Get user preferences for documentation structure and global scope
   const structureRules = getActiveRulesForScope("structure", []);
   const globalRules = getActiveRulesForScope("global", []);
 
@@ -185,4 +185,4 @@ export default async function checkNeedGenerateStructure(
   };
 }
 
-checkNeedGenerateStructure.taskTitle = "Check if document structure needs generate or update";
+checkNeedGenerateStructure.taskTitle = "Check if documentation structure needs generate or update";

package/agents/generate/document-structure-tools/add-document.mjs

@@ -41,7 +41,7 @@ export default async function addDocument(input) {
     sourceIds: [...sourceIds], // Create a copy of the array
   };
 
-  // Add the new document to the document structure
+  // Add the document to the structure
   const updatedStructure = [...documentStructure, newDocument];
 
   return {
@@ -50,7 +50,7 @@ export default async function addDocument(input) {
   };
 }
 
-addDocument.taskTitle = "Add new document";
-addDocument.description = "Add a new document to the document structure";
+addDocument.taskTitle = "Add document";
+addDocument.description = "Add a document to the documentation structure";
 addDocument.inputSchema = getAddDocumentInputJsonSchema();
 addDocument.outputSchema = getAddDocumentOutputJsonSchema();

package/agents/generate/document-structure-tools/delete-document.mjs

@@ -34,7 +34,7 @@ export default async function deleteDocument(input) {
     return { documentStructure };
   }
 
-  // Remove the document from the document structure
+  // Remove the document from the structure
   const updatedStructure = documentStructure.filter((_, index) => index !== documentIndex);
 
   return {
@@ -44,6 +44,6 @@ export default async function deleteDocument(input) {
 }
 
 deleteDocument.taskTitle = "Delete document";
-deleteDocument.description = "Delete a document from the document structure";
+deleteDocument.description = "Remove a document from the documentation structure";
 deleteDocument.inputSchema = getDeleteDocumentInputJsonSchema();
 deleteDocument.outputSchema = getDeleteDocumentOutputJsonSchema();

package/agents/generate/document-structure-tools/move-document.mjs

@@ -65,7 +65,7 @@ export default async function moveDocument(input) {
     parentId: newParentId || null,
   };
 
-  // Update the document structure
+  // Update the document's position in the structure
   const updatedStructure = [...documentStructure];
   updatedStructure[documentIndex] = updatedDocument;
 
@@ -77,6 +77,7 @@ export default async function moveDocument(input) {
 }
 
 moveDocument.taskTitle = "Move document";
-moveDocument.description = "Move a document to a different parent in the document structure";
+moveDocument.description =
+  "Relocate a document to a different parent in the documentation structure";
 moveDocument.inputSchema = getMoveDocumentInputJsonSchema();
 moveDocument.outputSchema = getMoveDocumentOutputJsonSchema();

package/agents/generate/document-structure-tools/update-document.mjs

@@ -33,7 +33,7 @@ export default async function updateDocument(input) {
     ...(sourceIds !== undefined && { sourceIds: [...sourceIds] }), // Create a copy of the array
   };
 
-  // Update the document structure
+  // Update the document in the structure
   const updatedStructure = [...documentStructure];
   updatedStructure[documentIndex] = updatedDocument;
 
@@ -45,6 +45,6 @@ export default async function updateDocument(input) {
 }
 
 updateDocument.taskTitle = "Update document";
-updateDocument.description = "Update properties of an existing document in the document structure";
+updateDocument.description = "Modify properties of a document in the documentation structure";
 updateDocument.inputSchema = getUpdateDocumentInputJsonSchema();
 updateDocument.outputSchema = getUpdateDocumentOutputJsonSchema();

package/agents/generate/generate-structure.yaml

@@ -13,7 +13,7 @@ input_schema:
       description: Primary language for documentation (e.g., zh, en, ja)
     datasources:
       type: string
-      description: Project content and context to help generate document structure
+      description: Project content and context to help generate documentation structure
     targetAudience:
       type: string
       description: Target audience for the documentation

package/agents/generate/update-document-structure.yaml

@@ -1,6 +1,6 @@
 type: ai
 name: updateDocumentStructure
-description: Update document structure based on user feedback and intentions using structure modification tools
+description: Update documentation structure based on user feedback and intentions using structure modification tools
 instructions:
   url: ../../prompts/structure/update-document-structure.md
 input_schema:
@@ -15,7 +15,7 @@ input_schema:
       description: User language, e.g. zh, en
     datasources:
       type: string
-      description: Context for document structure
+      description: Context for documentation structure
     glossary:
       type: string
       description: Glossary of terms
@@ -34,7 +34,7 @@ output_schema:
     documentStructure: ../schema/document-structure.yaml
     operationSummary:
       type: string
-      description: Summary of the operations performed on the document structure
+      description: Summary of the operations performed on the documentation structure
 skills:
   - ./document-structure-tools/add-document.mjs
   - ./document-structure-tools/delete-document.mjs

package/agents/generate/user-review-document-structure.mjs

@@ -48,13 +48,13 @@ function formatDocumentStructure(structure) {
 
 function printDocumentStructure(structure) {
   console.log(`\n  ${"-".repeat(50)}`);
-  console.log("  Current Document Structure");
+  console.log("  Current Documentation Structure");
   console.log(`  ${"-".repeat(50)}`);
 
   const { rootNodes, printNode } = formatDocumentStructure(structure);
 
   if (rootNodes.length === 0) {
-    console.log("  No document structure found.");
+    console.log("  No documentation structure found.");
   } else {
     rootNodes.forEach((node) => {
       printNode(node);
@@ -64,19 +64,19 @@ function printDocumentStructure(structure) {
 }
 
 export default async function userReviewDocumentStructure({ documentStructure, ...rest }, options) {
-  // Check if document structure exists
+  // Check if documentation structure exists
   if (!documentStructure || !Array.isArray(documentStructure) || documentStructure.length === 0) {
-    console.log("No document structure was generated to review.");
+    console.log("No documentation structure was generated to review.");
     return { documentStructure };
   }
 
-  // Print current document structure in a user-friendly format
+  // Print current documentation structure in a user-friendly format
   printDocumentStructure(documentStructure);
 
-  // Ask user if they want to review the document structure
+  // Ask user if they want to review the documentation structure
   const needReview = await options.prompts.select({
     message:
-      "Would you like to optimize the document structure?\n  You can edit titles, reorganize sections.",
+      "Would you like to optimize the documentation structure?\n  You can edit titles, reorganize sections.",
     choices: [
       {
         name: "Looks good - proceed with current structure",
@@ -117,7 +117,7 @@ export default async function userReviewDocumentStructure({ documentStructure, .
     const refineAgent = options.context.agents["updateDocumentStructure"];
     if (!refineAgent) {
       console.log(
-        "Unable to process your feedback - the document structure update feature is unavailable.",
+        "Unable to process your feedback - the documentation structure update feature is unavailable.",
       );
       console.log("Please try again later or contact support if this continues.");
       break;
@@ -157,7 +157,7 @@ export default async function userReviewDocumentStructure({ documentStructure, .
         }
       }
 
-      // Print current document structure in a user-friendly format
+      // Print current documentation structure in a user-friendly format
       printDocumentStructure(currentStructure);
     } catch (error) {
       console.error("Error processing your feedback:");
@@ -172,4 +172,4 @@ export default async function userReviewDocumentStructure({ documentStructure, .
   return { documentStructure: currentStructure };
 }
 
-userReviewDocumentStructure.taskTitle = "User review and modify document structure";
+userReviewDocumentStructure.taskTitle = "User review and modify documentation structure";

package/agents/update/batch-generate-document.yaml

@@ -8,7 +8,7 @@ input_schema:
   properties:
     datasources:
       type: string
-      description: Context for document structure generation, used to assist generate document structure
+      description: Context for documentation structure generation, used to assist generate documentation structure
     documentExecutionStructure: ../schema/document-execution-structure.yaml
     modifiedFiles:
       type: array

package/agents/update/check-document.mjs

@@ -36,10 +36,10 @@ export default async function checkDocument(
     detailGenerated = false;
   }
 
-  // Check if sourceIds have changed by comparing with original document structure
+  // Check if sourceIds have changed by comparing with original documentation structure
   let sourceIdsChanged = false;
   if (originalDocumentStructure && sourceIds) {
-    // Find the original node in the document structure
+    // Find the original node in the documentation structure
     const originalNode = originalDocumentStructure.find((node) => node.path === path);
 
     if (originalNode?.sourceIds) {

package/agents/utils/check-feedback-refiner.mjs

@@ -62,7 +62,7 @@ checkFeedbackRefiner.input_schema = {
     },
     documentStructureFeedback: {
       type: "string",
-      description: "Feedback from document structure stage",
+      description: "Feedback from documentation structure stage",
     },
     stage: {
       type: "string",

package/agents/utils/choose-docs.mjs

@@ -41,7 +41,7 @@ export default async function chooseDocs(
 
       // Convert files to choices with titles
       const choices = mainLanguageFiles.map((file) => {
-        // Convert filename to flat path to find corresponding document structure item
+        // Convert filename to flat path to find corresponding documentation structure item
         const flatName = file.replace(/\.md$/, "").replace(/\.\w+(-\w+)?$/, "");
         const docItem = documentExecutionStructure.find((item) => {
           const itemFlattenedPath = item.path.replace(/^\//, "").replace(/\//g, "-");

package/agents/utils/load-document-all-content.mjs

@@ -4,19 +4,19 @@ import { findItemByPath, readFileContent } from "../../utils/docs-finder-utils.m
 /**
  * Loads a document's content along with all its translations from the docs directory.
  *
- * This function finds a document by its path in the document structure, then searches
+ * This function finds a document by its path in the documentation structure, then searches
  * for all translation files in the docs directory that match the document's naming pattern.
  * Translation files are identified by the pattern: {flatName}.{language-code}.md
  *
  * @param {Object} params - The parameters object
  * @param {string} params.path - The document path to find in the structure
  * @param {string} params.docsDir - The directory containing document files and translations
- * @param {Object} params.documentStructure - The document structure object to search in
+ * @param {Object} params.documentStructure - The documentation structure object to search in
  * @returns {Promise<Object>} An object containing the document data with translations
  * @throws {Error} Throws an error if the document path is not found in the structure
  */
 export default async function loadDocumentAllContent({ path, docsDir, documentStructure }) {
-  // Find the document item by path in the document structure
+  // Find the document item by path in the documentation structure
   const result = await findItemByPath(documentStructure, path, null, docsDir);
 
   if (!result) {

package/agents/utils/load-sources.mjs

@@ -175,7 +175,7 @@ export default async function loadSources({
     }),
   );
 
-  // Get the last document structure
+  // Get the last documentation structure
   let originalDocumentStructure;
   if (outputDir) {
     const documentStructurePath = path.join(outputDir, "structure-plan.json");

package/agents/utils/save-docs.mjs

@@ -35,39 +35,18 @@ export default async function saveDocs({
     console.error("Failed to save _sidebar.md:", err.message);
   }
 
-  // Clean up invalid .md files that are no longer in the document structure
+  // Clean up invalid .md files that are no longer in the documentation structure
   try {
     await cleanupInvalidFiles(documentStructure, docsDir, translateLanguages, locale);
   } catch (err) {
     console.error("Failed to cleanup invalid .md files:", err.message);
   }
 
-  const message = `# ✅ Documentation Generated Successfully!
-
-Generated **${documentStructure.length}** documents and saved to: \`${docsDir}\`
+  const message = `
+✅ Documentation generated successfully! (\`${documentStructure.length}\` documents → \`${docsDir}\`)
 ${projectInfoMessage || ""}
-## 🚀 Next Steps
-
-**Publish Your Documentation**
-
-Generate a shareable preview link for your team:
-
-  \`aigne doc publish\`
-
-## 🔧 Optional Actions
-
-**Update Specific Documents**
-
-Regenerate content for individual documents:
-
-  \`aigne doc update\`
-
-**Refine Document Structure**
-
-Review and improve your documentation organization:
-
-  \`aigne doc generate\`
-
+🚀 Next: Make your documentation live and generate a shareable link, run: \`aigne doc publish\`
+💡 Optional: Update specific document (\`aigne doc update\`) or refine documentation structure (\`aigne doc generate\`)
   `;
 
   // Shutdown mermaid worker pool to ensure clean exit
@@ -94,7 +73,7 @@ function generateFileName(flatName, language) {
 }
 
 /**
- * Clean up .md files that are no longer in the document structure
+ * Clean up .md files that are no longer in the documentation structure
  * @param {Array<{path: string, title: string}>} documentStructure
  * @param {string} docsDir
  * @param {Array<string>} translateLanguages
@@ -109,7 +88,7 @@ async function cleanupInvalidFiles(documentStructure, docsDir, translateLanguage
     const files = await readdir(docsDir);
     const mdFiles = files.filter((file) => file.endsWith(".md"));
 
-    // Generate expected file names from document structure
+    // Generate expected file names from documentation structure
     const expectedFiles = new Set();
 
     // Add main document files

package/aigne.yaml

@@ -9,7 +9,7 @@ agents:
   # Initialization
   - ./agents/init/index.mjs
 
-  # Document Structure Generation
+  # Documentation Structure Generation
   - ./agents/generate/generate-structure.yaml
   - ./agents/generate/update-document-structure.yaml
   - ./agents/generate/check-need-generate-structure.mjs
@@ -18,7 +18,7 @@ agents:
   - ./agents/generate/user-review-document-structure.mjs
   - ./agents/generate/index.yaml
   
-  # Document Structure Tools
+  # Documentation Structure Tools
   - ./agents/generate/document-structure-tools/add-document.mjs
   - ./agents/generate/document-structure-tools/delete-document.mjs
   - ./agents/generate/document-structure-tools/update-document.mjs

package/docs/_sidebar.md

@@ -14,4 +14,4 @@
 * [Advanced Topics](/advanced.md)
   * [How It Works](/advanced-how-it-works.md)
   * [Quality Assurance](/advanced-quality-assurance.md)
-* [Changelog](/changelog.md)
+* [Changelog](/changelog.md)

package/docs/advanced-how-it-works.md

@@ -73,7 +73,7 @@ User-Feedback -> Pipeline.Content-Generation: "Regenerate Content"
 
 1.  **Input Analysis**: The process begins when agents load your source code and project configuration (`aigne.yaml`).
 
-2.  **Structure Planning**: An agent analyzes the codebase to propose a logical document structure. It creates an outline based on the project's composition and any specified rules.
+2.  **Structure Planning**: An agent analyzes the codebase to propose a logical documentation structure. It creates an outline based on the project's composition and any specified rules.
 
 3.  **Content Generation**: With the structure in place, content generation agents populate each section of the document plan with detailed text, code examples, and explanations.
 
@@ -88,8 +88,8 @@ DocSmith's functionality is provided by a collection of agents defined in the pr
 | Functional Role          | Key Agent Files                                      | Description                                                                          |
 | ------------------------ | ---------------------------------------------------- | ------------------------------------------------------------------------------------ |
 | **Structure Planning**   | `generate/generate-structure.yaml`                   | Analyzes source code to propose the initial document outline.                        |
-| **Structure Refinement** | `generate/refine-document-structure.yaml`            | Modifies the document structure based on user feedback.                              |
-| **Content Generation**   | `update/batch-generate-document.yaml`, `generate-document.yaml` | Populates the document structure with detailed content for each section.             |
+| **Structure Refinement** | `generate/refine-document-structure.yaml`            | Modifies the documentation structure based on user feedback.                              |
+| **Content Generation**   | `update/batch-generate-document.yaml`, `generate-document.yaml` | Populates the documentation structure with detailed content for each section.             |
 | **Translation**          | `translate/translate-document.yaml`, `translate-multilingual.yaml` | Translates generated documentation into multiple target languages.                   |
 | **Publishing**           | `publish/publish-docs.mjs`                           | Manages the process of publishing documents to Discuss Kit instances.                |
 | **Data I/O**             | `utils/load-sources.mjs`, `utils/save-docs.mjs`      | Responsible for reading source files and writing the final markdown documents to disk. |

package/docs/advanced-quality-assurance.md

@@ -68,7 +68,7 @@ DocSmith performs several checks to ensure the structural integrity of the conte
 
 #### Link and Media Integrity
 
-- **Link Integrity**: All relative links within the documentation are validated against the document structure plan to prevent dead links. This ensures that all internal navigation works as expected. The checker ignores external links (starting with `http://` or `https://`) and `mailto:` links.
+- **Link Integrity**: All relative links within the documentation are validated against the documentation structure to prevent dead links. This ensures that all internal navigation works as expected. The checker ignores external links (starting with `http://` or `https://`) and `mailto:` links.
 
 - **Image Validation**: To avoid broken images, the checker verifies that any local image file referenced in the documentation exists on the file system. It resolves both relative and absolute paths to confirm the file is present. External image URLs and data URLs are not checked.