@aigne/doc-smith 0.8.3 → 0.8.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (51) hide show
  1. package/.aigne/doc-smith/config.yaml +3 -3
  2. package/.aigne/doc-smith/preferences.yml +58 -12
  3. package/.aigne/doc-smith/upload-cache.yaml +600 -207
  4. package/CHANGELOG.md +10 -0
  5. package/README.md +77 -5
  6. package/docs/advanced-how-it-works.md +55 -60
  7. package/docs/advanced-how-it-works.zh.md +60 -65
  8. package/docs/advanced-quality-assurance.md +73 -38
  9. package/docs/advanced-quality-assurance.zh.md +73 -38
  10. package/docs/advanced.md +2 -14
  11. package/docs/advanced.zh.md +5 -17
  12. package/docs/changelog.md +41 -4
  13. package/docs/changelog.zh.md +77 -40
  14. package/docs/cli-reference.md +79 -13
  15. package/docs/cli-reference.zh.md +92 -26
  16. package/docs/configuration-interactive-setup.md +102 -49
  17. package/docs/configuration-interactive-setup.zh.md +102 -49
  18. package/docs/configuration-language-support.md +69 -39
  19. package/docs/configuration-language-support.zh.md +68 -38
  20. package/docs/configuration-llm-setup.md +25 -62
  21. package/docs/configuration-llm-setup.zh.md +25 -62
  22. package/docs/configuration-preferences.md +79 -67
  23. package/docs/configuration-preferences.zh.md +78 -67
  24. package/docs/configuration.md +122 -109
  25. package/docs/configuration.zh.md +130 -117
  26. package/docs/features-generate-documentation.md +44 -24
  27. package/docs/features-generate-documentation.zh.md +52 -32
  28. package/docs/features-publish-your-docs.md +41 -40
  29. package/docs/features-publish-your-docs.zh.md +50 -49
  30. package/docs/features-translate-documentation.md +73 -17
  31. package/docs/features-translate-documentation.zh.md +76 -20
  32. package/docs/features-update-and-refine.md +72 -21
  33. package/docs/features-update-and-refine.zh.md +80 -29
  34. package/docs/features.md +24 -28
  35. package/docs/features.zh.md +25 -29
  36. package/docs/getting-started.md +87 -38
  37. package/docs/getting-started.zh.md +88 -39
  38. package/docs/overview.md +17 -35
  39. package/docs/overview.zh.md +18 -36
  40. package/package.json +9 -8
  41. package/prompts/content-detail-generator.md +1 -0
  42. package/prompts/document/custom-code-block.md +101 -0
  43. package/prompts/document/d2-chart/rules.md +941 -1031
  44. package/prompts/document/detail-generator.md +7 -53
  45. package/tests/kroki-utils.test.mjs +88 -17
  46. package/utils/constants.mjs +15 -1
  47. package/utils/kroki-utils.mjs +22 -14
  48. package/utils/markdown-checker.mjs +1 -1
  49. package/utils/utils.mjs +3 -2
  50. package/prompts/document/d2-chart/diy-examples.md +0 -44
  51. package/prompts/document/d2-chart/shape-rules.md +0 -182
@@ -50,6 +50,8 @@ documentationDepth: comprehensive
50
50
 
51
51
  # Custom Rules: Define specific documentation generation rules and requirements
52
52
  rules: |
53
+ Avoid using vague or empty words that don't provide measurable or specific details, such as 'intelligently', 'seamlessly', 'comprehensive', or 'high-quality'. Focus on concrete, verifiable facts and information.
54
+ Focus on concrete, verifiable facts and information.
53
55
 
54
56
 
55
57
  # Target Audience: Describe your specific target audience and their characteristics
@@ -62,9 +64,7 @@ translateLanguages:
62
64
  docsDir: ./docs # Directory to save generated documentation
63
65
  sourcesPath: # Source code paths to analyze
64
66
  - ./
65
- labels:
66
- - Reference
67
67
  lastGitHead: f3f14b93e6b2e6beb42b2f368c2560ab050dfd03
68
68
  appUrl: https://docsmith.aigne.io
69
69
  # ⚠️ Warning: boardId is auto-generated by system, please do not edit manually
70
- boardId: "aigne-docsmith"
70
+ boardId: "docsmith"
@@ -1,31 +1,77 @@
1
1
  rules:
2
- - id: pref_b826d60409e88585
2
+ - id: pref_0e628173a762f68f
3
3
  active: true
4
4
  scope: document
5
- rule: 自定义组件的描述中只能使用普通文本,不能使用 Markdown 语法。
6
- feedback: 不可以在自定义组件的描述中使用 markdown 语法,只能使用普通文本
7
- createdAt: 2025-08-30T14:59:26.086Z
5
+ rule: When specifying Claude models, must use the format `anthropic:claude-3-5-sonnet`.
6
+ feedback: Claude models need to be specified like this anthropic:claude-3-5-sonnet
7
+ createdAt: 2025-09-07T02:27:18.528Z
8
+ - id: pref_6e612d7ca8b7f3b6
9
+ active: true
10
+ scope: document
11
+ rule: When describing publishing options, should use plain text instead of custom components, and recommend users to run their own Discuss Kit instance while providing relevant links.
12
+ feedback: Publishing options should not use custom components: recommend users to run their own Discuss Kit instance in the text, and add Discuss Kit related links
13
+ createdAt: 2025-09-07T02:18:22.237Z
14
+ - id: pref_039b58c47bdf95c9
15
+ active: true
16
+ scope: document
17
+ rule: In the "Prerequisites" section, should briefly introduce Node.js installation, specify using npm instead of pnpm, and guide users to the official website for detailed instructions.
18
+ feedback: "In the prerequisites section, provide a simple introduction on how to install Node.js, no need to install pnpm but use npm instead, guide users to the product official website for detailed installation instructions"
19
+ createdAt: 2025-09-07T02:06:39.559Z
20
+ - id: pref_03a45a593f645ce2
21
+ active: true
22
+ scope: document
23
+ rule: When describing Discuss Kit, must clearly state that it is a non-open-source service running on the official platform, not a self-hosted instance.
24
+ feedback: In the core features description about document publishing, show the official platform link, run your own Discuss Kit instance, not self-hosted: Discuss Kit is not open source.
25
+ createdAt: 2025-09-07T01:59:12.876Z
26
+ - id: pref_0c239f619329089f
27
+ active: true
28
+ scope: document
29
+ rule: In the core features section, should use plain list format and add descriptions and links for AIGNE Hub and Discuss Kit.
30
+ feedback: Core features section should not use custom component lists, change to plain lists, add descriptions and links for AIGNE Hub and Discuss Kit to help users understand these two products
31
+ createdAt: 2025-09-07T01:53:22.969Z
32
+ paths:
33
+ - /overview
34
+ - id: pref_4e8aa735b11d8484
35
+ active: true
36
+ scope: document
37
+ rule: In the 'How It Works' document, only show DocSmith implementation details, should not include AIGNE Framework information.
38
+ feedback: How it works section does not need to show AIGNE Framework, only need to show DocSmith implementation
39
+ createdAt: 2025-09-06T13:15:10.272Z
40
+ paths:
41
+ - /advanced/how-it-works
42
+ - id: pref_4ad26164f1f4fbf6
43
+ active: true
44
+ scope: document
45
+ rule: When describing multi-language support features, must clearly state support for 12 languages and list two to three mainstream languages as examples.
46
+ feedback: Multi-language support related features, clearly support 12 languages, no above statement, and give examples of two or three mainstream languages
47
+ createdAt: 2025-09-06T12:55:42.678Z
48
+ - id: pref_c84baec514ca5c60
49
+ active: true
50
+ scope: document
51
+ rule: Core features list must describe product functionality characteristics, not promotional value or importance.
52
+ feedback: Core features list should describe DocSmith's functional characteristics, not describe product importance like a promotional brochure
53
+ createdAt: 2025-09-06T12:47:46.583Z
8
54
  - id: pref_6da200d8e6fec09e
9
55
  active: true
10
56
  scope: structure
11
- rule: 不要生成关于贡献指南的文档。
12
- feedback: 删除贡献指南相关的文档,这部分内容还没有准备好
57
+ rule: Do not generate documentation about contribution guidelines.
58
+ feedback: Remove contribution guidelines related documentation, this content is not ready yet
13
59
  createdAt: 2025-08-30T14:46:32.741Z
14
60
  - id: pref_8c619b5228f791e5
15
61
  active: true
16
62
  scope: document
17
- rule: 不要生成关于 Mermaid 图表验证的内容,因为图表已改为使用 D2
18
- feedback: 删除 mermaid 图表验证相关的描述,现在图表已改为使用 D2
63
+ rule: Do not generate content about Mermaid chart validation, as charts have been changed to use D2.
64
+ feedback: Remove mermaid chart validation related descriptions, charts now use D2
19
65
  createdAt: 2025-08-30T14:29:04.068Z
20
66
  - id: pref_0e154f58c22329fb
21
67
  active: true
22
68
  scope: document
23
- rule: 不要生成关于已不再支持的开发命令的文档内容。
24
- feedback: 删除开发命令相关的文档,这些开发命令已经不支持了
69
+ rule: Do not generate documentation content about development commands that are no longer supported.
70
+ feedback: Remove development command related documentation, these development commands are no longer supported
25
71
  createdAt: 2025-08-30T14:13:50.446Z
26
72
  - id: pref_0112657e4103ba88
27
73
  active: true
28
74
  scope: structure
29
- rule: 根据最新的源码更新文档结构,可以新增文档和修改文档对源码的依赖,但禁止修改任何现有文档的路径。
30
- feedback: 基于最新的源码更新文档结构,允许新增文档、修改文档依赖源码,不可以修改现有文档的路径
75
+ rule: Update documentation structure based on the latest source code, can add new documents and modify document dependencies on source code, but prohibit modifying any existing document paths.
76
+ feedback: Update documentation structure based on the latest source code, allow adding new documents and modifying document dependencies on source code, cannot modify existing document paths
31
77
  createdAt: 2025-08-30T14:03:47.434Z