@aigne/doc-smith 0.8.12-beta.8 → 0.8.12
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.
- package/CHANGELOG.md +15 -0
- package/agents/publish/index.yaml +4 -0
- package/agents/publish/publish-docs.mjs +77 -5
- package/agents/publish/translate-meta.mjs +103 -0
- package/agents/update/generate-document.yaml +30 -28
- package/agents/update/update-document-detail.yaml +3 -1
- package/agents/utils/update-branding.mjs +69 -0
- package/package.json +16 -2
- package/prompts/common/document/role-and-personality.md +3 -1
- package/prompts/detail/d2-diagram/guide.md +7 -1
- package/prompts/detail/d2-diagram/user-prompt.md +3 -0
- package/prompts/detail/generate/system-prompt.md +6 -7
- package/prompts/detail/generate/user-prompt.md +12 -3
- package/prompts/detail/update/user-prompt.md +0 -2
- package/prompts/structure/update/user-prompt.md +0 -4
- package/utils/file-utils.mjs +69 -24
- package/utils/markdown-checker.mjs +0 -20
- package/utils/request.mjs +7 -0
- package/utils/upload-files.mjs +231 -0
- package/utils/utils.mjs +11 -1
- package/.aigne/doc-smith/config.yaml +0 -77
- package/.aigne/doc-smith/history.yaml +0 -37
- package/.aigne/doc-smith/media-description.yaml +0 -91
- package/.aigne/doc-smith/output/structure-plan.json +0 -162
- package/.aigne/doc-smith/preferences.yml +0 -97
- package/.aigne/doc-smith/upload-cache.yaml +0 -1830
- package/.github/PULL_REQUEST_TEMPLATE.md +0 -28
- package/.github/workflows/ci.yml +0 -54
- package/.github/workflows/create-release-pr.yaml +0 -21
- package/.github/workflows/publish-docs.yml +0 -65
- package/.github/workflows/release.yml +0 -49
- package/.github/workflows/reviewer.yml +0 -54
- package/.release-please-manifest.json +0 -3
- package/RELEASE.md +0 -9
- package/assets/screenshots/doc-complete-setup.png +0 -0
- package/assets/screenshots/doc-generate-docs.png +0 -0
- package/assets/screenshots/doc-generate.png +0 -0
- package/assets/screenshots/doc-generated-successfully.png +0 -0
- package/assets/screenshots/doc-publish.png +0 -0
- package/assets/screenshots/doc-regenerate.png +0 -0
- package/assets/screenshots/doc-translate-langs.png +0 -0
- package/assets/screenshots/doc-translate.png +0 -0
- package/assets/screenshots/doc-update.png +0 -0
- package/biome.json +0 -73
- package/codecov.yml +0 -15
- package/docs/_sidebar.md +0 -15
- package/docs/configuration-initial-setup.ja.md +0 -179
- package/docs/configuration-initial-setup.md +0 -198
- package/docs/configuration-initial-setup.zh-TW.md +0 -179
- package/docs/configuration-initial-setup.zh.md +0 -179
- package/docs/configuration-managing-preferences.ja.md +0 -100
- package/docs/configuration-managing-preferences.md +0 -100
- package/docs/configuration-managing-preferences.zh-TW.md +0 -100
- package/docs/configuration-managing-preferences.zh.md +0 -100
- package/docs/configuration.ja.md +0 -69
- package/docs/configuration.md +0 -69
- package/docs/configuration.zh-TW.md +0 -69
- package/docs/configuration.zh.md +0 -69
- package/docs/getting-started.ja.md +0 -107
- package/docs/getting-started.md +0 -107
- package/docs/getting-started.zh-TW.md +0 -107
- package/docs/getting-started.zh.md +0 -107
- package/docs/guides-cleaning-up.ja.md +0 -51
- package/docs/guides-cleaning-up.md +0 -52
- package/docs/guides-cleaning-up.zh-TW.md +0 -51
- package/docs/guides-cleaning-up.zh.md +0 -51
- package/docs/guides-evaluating-documents.ja.md +0 -66
- package/docs/guides-evaluating-documents.md +0 -107
- package/docs/guides-evaluating-documents.zh-TW.md +0 -66
- package/docs/guides-evaluating-documents.zh.md +0 -66
- package/docs/guides-generating-documentation.ja.md +0 -151
- package/docs/guides-generating-documentation.md +0 -89
- package/docs/guides-generating-documentation.zh-TW.md +0 -151
- package/docs/guides-generating-documentation.zh.md +0 -151
- package/docs/guides-interactive-chat.ja.md +0 -85
- package/docs/guides-interactive-chat.md +0 -93
- package/docs/guides-interactive-chat.zh-TW.md +0 -85
- package/docs/guides-interactive-chat.zh.md +0 -85
- package/docs/guides-managing-history.ja.md +0 -48
- package/docs/guides-managing-history.md +0 -53
- package/docs/guides-managing-history.zh-TW.md +0 -48
- package/docs/guides-managing-history.zh.md +0 -48
- package/docs/guides-publishing-your-docs.ja.md +0 -78
- package/docs/guides-publishing-your-docs.md +0 -83
- package/docs/guides-publishing-your-docs.zh-TW.md +0 -78
- package/docs/guides-publishing-your-docs.zh.md +0 -78
- package/docs/guides-translating-documentation.ja.md +0 -95
- package/docs/guides-translating-documentation.md +0 -100
- package/docs/guides-translating-documentation.zh-TW.md +0 -95
- package/docs/guides-translating-documentation.zh.md +0 -95
- package/docs/guides-updating-documentation.ja.md +0 -77
- package/docs/guides-updating-documentation.md +0 -79
- package/docs/guides-updating-documentation.zh-TW.md +0 -77
- package/docs/guides-updating-documentation.zh.md +0 -77
- package/docs/guides.ja.md +0 -32
- package/docs/guides.md +0 -32
- package/docs/guides.zh-TW.md +0 -32
- package/docs/guides.zh.md +0 -32
- package/docs/overview.ja.md +0 -61
- package/docs/overview.md +0 -61
- package/docs/overview.zh-TW.md +0 -61
- package/docs/overview.zh.md +0 -61
- package/docs/release-notes.ja.md +0 -255
- package/docs/release-notes.md +0 -288
- package/docs/release-notes.zh-TW.md +0 -255
- package/docs/release-notes.zh.md +0 -255
- package/prompts/common/afs/afs-tools-usage.md +0 -5
- package/prompts/common/afs/use-afs-instruction.md +0 -1
- package/release-please-config.json +0 -14
- package/tests/agents/chat/chat.test.mjs +0 -46
- package/tests/agents/clear/choose-contents.test.mjs +0 -284
- package/tests/agents/clear/clear-auth-tokens.test.mjs +0 -268
- package/tests/agents/clear/clear-document-config.test.mjs +0 -167
- package/tests/agents/clear/clear-document-structure.test.mjs +0 -380
- package/tests/agents/clear/clear-generated-docs.test.mjs +0 -222
- package/tests/agents/evaluate/code-snippet.test.mjs +0 -163
- package/tests/agents/evaluate/fixtures/api-services.md +0 -87
- package/tests/agents/evaluate/fixtures/js-sdk.md +0 -94
- package/tests/agents/evaluate/generate-report.test.mjs +0 -312
- package/tests/agents/generate/check-document-structure.test.mjs +0 -45
- package/tests/agents/generate/check-need-generate-structure.test.mjs +0 -279
- package/tests/agents/generate/document-structure-tools/add-document.test.mjs +0 -449
- package/tests/agents/generate/document-structure-tools/delete-document.test.mjs +0 -410
- package/tests/agents/generate/document-structure-tools/generate-sub-structure.test.mjs +0 -277
- package/tests/agents/generate/document-structure-tools/move-document.test.mjs +0 -476
- package/tests/agents/generate/document-structure-tools/update-document.test.mjs +0 -548
- package/tests/agents/generate/generate-structure.test.mjs +0 -45
- package/tests/agents/generate/user-review-document-structure.test.mjs +0 -319
- package/tests/agents/history/view.test.mjs +0 -97
- package/tests/agents/init/init.test.mjs +0 -1657
- package/tests/agents/prefs/prefs.test.mjs +0 -431
- package/tests/agents/publish/publish-docs.test.mjs +0 -787
- package/tests/agents/translate/choose-language.test.mjs +0 -311
- package/tests/agents/translate/translate-document.test.mjs +0 -51
- package/tests/agents/update/check-document.test.mjs +0 -463
- package/tests/agents/update/check-update-is-single.test.mjs +0 -300
- package/tests/agents/update/document-tools/update-document-content.test.mjs +0 -329
- package/tests/agents/update/generate-document.test.mjs +0 -51
- package/tests/agents/update/save-and-translate-document.test.mjs +0 -369
- package/tests/agents/update/user-review-document.test.mjs +0 -582
- package/tests/agents/utils/action-success.test.mjs +0 -54
- package/tests/agents/utils/check-detail-result.test.mjs +0 -743
- package/tests/agents/utils/check-feedback-refiner.test.mjs +0 -478
- package/tests/agents/utils/choose-docs.test.mjs +0 -406
- package/tests/agents/utils/exit.test.mjs +0 -70
- package/tests/agents/utils/feedback-refiner.test.mjs +0 -51
- package/tests/agents/utils/find-item-by-path.test.mjs +0 -517
- package/tests/agents/utils/find-user-preferences-by-path.test.mjs +0 -382
- package/tests/agents/utils/format-document-structure.test.mjs +0 -364
- package/tests/agents/utils/fs.test.mjs +0 -267
- package/tests/agents/utils/load-sources.test.mjs +0 -1470
- package/tests/agents/utils/save-docs.test.mjs +0 -109
- package/tests/agents/utils/save-output.test.mjs +0 -315
- package/tests/agents/utils/save-single-doc.test.mjs +0 -364
- package/tests/agents/utils/transform-detail-datasources.test.mjs +0 -320
- package/tests/utils/auth-utils.test.mjs +0 -596
- package/tests/utils/blocklet.test.mjs +0 -336
- package/tests/utils/conflict-detector.test.mjs +0 -355
- package/tests/utils/constants.test.mjs +0 -295
- package/tests/utils/d2-utils.test.mjs +0 -437
- package/tests/utils/deploy.test.mjs +0 -399
- package/tests/utils/docs-finder-utils.test.mjs +0 -650
- package/tests/utils/file-utils.test.mjs +0 -521
- package/tests/utils/history-utils.test.mjs +0 -206
- package/tests/utils/kroki-utils.test.mjs +0 -646
- package/tests/utils/linter/fixtures/css/keyword-error.css +0 -1
- package/tests/utils/linter/fixtures/css/missing-semicolon.css +0 -1
- package/tests/utils/linter/fixtures/css/syntax-error.css +0 -1
- package/tests/utils/linter/fixtures/css/undeclare-variable.css +0 -1
- package/tests/utils/linter/fixtures/css/unused-variable.css +0 -2
- package/tests/utils/linter/fixtures/css/valid-code.css +0 -1
- package/tests/utils/linter/fixtures/dockerfile/keyword-error.dockerfile +0 -1
- package/tests/utils/linter/fixtures/dockerfile/missing-semicolon.dockerfile +0 -2
- package/tests/utils/linter/fixtures/dockerfile/syntax-error.dockerfile +0 -2
- package/tests/utils/linter/fixtures/dockerfile/undeclare-variable.dockerfile +0 -1
- package/tests/utils/linter/fixtures/dockerfile/unused-variable.dockerfile +0 -1
- package/tests/utils/linter/fixtures/dockerfile/valid-code.dockerfile +0 -2
- package/tests/utils/linter/fixtures/go/keyword-error.go +0 -5
- package/tests/utils/linter/fixtures/go/missing-semicolon.go +0 -5
- package/tests/utils/linter/fixtures/go/syntax-error.go +0 -6
- package/tests/utils/linter/fixtures/go/undeclare-variable.go +0 -5
- package/tests/utils/linter/fixtures/go/unused-variable.go +0 -5
- package/tests/utils/linter/fixtures/go/valid-code.go +0 -7
- package/tests/utils/linter/fixtures/js/keyword-error.js +0 -3
- package/tests/utils/linter/fixtures/js/missing-semicolon.js +0 -6
- package/tests/utils/linter/fixtures/js/syntax-error.js +0 -4
- package/tests/utils/linter/fixtures/js/undeclare-variable.js +0 -3
- package/tests/utils/linter/fixtures/js/unused-variable.js +0 -7
- package/tests/utils/linter/fixtures/js/valid-code.js +0 -15
- package/tests/utils/linter/fixtures/json/keyword-error.json +0 -1
- package/tests/utils/linter/fixtures/json/missing-semicolon.json +0 -1
- package/tests/utils/linter/fixtures/json/syntax-error.json +0 -1
- package/tests/utils/linter/fixtures/json/undeclare-variable.json +0 -1
- package/tests/utils/linter/fixtures/json/unused-variable.json +0 -1
- package/tests/utils/linter/fixtures/json/valid-code.json +0 -1
- package/tests/utils/linter/fixtures/jsx/keyword-error.jsx +0 -5
- package/tests/utils/linter/fixtures/jsx/missing-semicolon.jsx +0 -5
- package/tests/utils/linter/fixtures/jsx/syntax-error.jsx +0 -5
- package/tests/utils/linter/fixtures/jsx/undeclare-variable.jsx +0 -5
- package/tests/utils/linter/fixtures/jsx/unused-variable.jsx +0 -4
- package/tests/utils/linter/fixtures/jsx/valid-code.jsx +0 -5
- package/tests/utils/linter/fixtures/python/keyword-error.py +0 -3
- package/tests/utils/linter/fixtures/python/missing-semicolon.py +0 -2
- package/tests/utils/linter/fixtures/python/syntax-error.py +0 -3
- package/tests/utils/linter/fixtures/python/undeclare-variable.py +0 -3
- package/tests/utils/linter/fixtures/python/unused-variable.py +0 -6
- package/tests/utils/linter/fixtures/python/valid-code.py +0 -12
- package/tests/utils/linter/fixtures/ruby/keyword-error.rb +0 -2
- package/tests/utils/linter/fixtures/ruby/missing-semicolon.rb +0 -1
- package/tests/utils/linter/fixtures/ruby/syntax-error.rb +0 -2
- package/tests/utils/linter/fixtures/ruby/undeclare-variable.rb +0 -1
- package/tests/utils/linter/fixtures/ruby/unused-variable.rb +0 -2
- package/tests/utils/linter/fixtures/ruby/valid-code.rb +0 -1
- package/tests/utils/linter/fixtures/sass/keyword-error.sass +0 -2
- package/tests/utils/linter/fixtures/sass/missing-semicolon.sass +0 -3
- package/tests/utils/linter/fixtures/sass/syntax-error.sass +0 -3
- package/tests/utils/linter/fixtures/sass/undeclare-variable.sass +0 -2
- package/tests/utils/linter/fixtures/sass/unused-variable.sass +0 -4
- package/tests/utils/linter/fixtures/sass/valid-code.sass +0 -2
- package/tests/utils/linter/fixtures/scss/keyword-error.scss +0 -1
- package/tests/utils/linter/fixtures/scss/missing-semicolon.scss +0 -1
- package/tests/utils/linter/fixtures/scss/syntax-error.scss +0 -1
- package/tests/utils/linter/fixtures/scss/undeclare-variable.scss +0 -1
- package/tests/utils/linter/fixtures/scss/unused-variable.scss +0 -2
- package/tests/utils/linter/fixtures/scss/valid-code.scss +0 -1
- package/tests/utils/linter/fixtures/shell/keyword-error.sh +0 -5
- package/tests/utils/linter/fixtures/shell/missing-semicolon.sh +0 -3
- package/tests/utils/linter/fixtures/shell/syntax-error.sh +0 -4
- package/tests/utils/linter/fixtures/shell/undeclare-variable.sh +0 -3
- package/tests/utils/linter/fixtures/shell/unused-variable.sh +0 -4
- package/tests/utils/linter/fixtures/shell/valid-code.sh +0 -3
- package/tests/utils/linter/fixtures/ts/keyword-error.ts +0 -1
- package/tests/utils/linter/fixtures/ts/missing-semicolon.ts +0 -1
- package/tests/utils/linter/fixtures/ts/syntax-error.ts +0 -1
- package/tests/utils/linter/fixtures/ts/undeclare-variable.ts +0 -1
- package/tests/utils/linter/fixtures/ts/unused-variable.ts +0 -3
- package/tests/utils/linter/fixtures/ts/valid-code.ts +0 -3
- package/tests/utils/linter/fixtures/tsx/keyword-error.tsx +0 -5
- package/tests/utils/linter/fixtures/tsx/missing-semicolon.tsx +0 -5
- package/tests/utils/linter/fixtures/tsx/syntax-error.tsx +0 -5
- package/tests/utils/linter/fixtures/tsx/undeclare-variable.tsx +0 -6
- package/tests/utils/linter/fixtures/tsx/unused-variable.tsx +0 -6
- package/tests/utils/linter/fixtures/tsx/valid-code.tsx +0 -5
- package/tests/utils/linter/fixtures/vue/keyword-error.vue +0 -6
- package/tests/utils/linter/fixtures/vue/missing-semicolon.vue +0 -6
- package/tests/utils/linter/fixtures/vue/syntax-error.vue +0 -6
- package/tests/utils/linter/fixtures/vue/undeclare-variable.vue +0 -6
- package/tests/utils/linter/fixtures/vue/unused-variable.vue +0 -7
- package/tests/utils/linter/fixtures/vue/valid-code.vue +0 -6
- package/tests/utils/linter/fixtures/yaml/keyword-error.yml +0 -1
- package/tests/utils/linter/fixtures/yaml/missing-semicolon.yml +0 -2
- package/tests/utils/linter/fixtures/yaml/syntax-error.yml +0 -1
- package/tests/utils/linter/fixtures/yaml/undeclare-variable.yml +0 -1
- package/tests/utils/linter/fixtures/yaml/unused-variable.yml +0 -2
- package/tests/utils/linter/fixtures/yaml/valid-code.yml +0 -3
- package/tests/utils/linter/index.test.mjs +0 -440
- package/tests/utils/linter/scan-results.mjs +0 -42
- package/tests/utils/load-config.test.mjs +0 -141
- package/tests/utils/markdown/index.test.mjs +0 -478
- package/tests/utils/mermaid-validator.test.mjs +0 -541
- package/tests/utils/mock-chat-model.mjs +0 -12
- package/tests/utils/preferences-utils.test.mjs +0 -465
- package/tests/utils/save-value-to-config.test.mjs +0 -483
- package/tests/utils/utils.test.mjs +0 -941
|
@@ -1,162 +0,0 @@
|
|
|
1
|
-
[
|
|
2
|
-
{
|
|
3
|
-
"title": "Overview",
|
|
4
|
-
"description": "Explains what AIGNE DocSmith does, the problems it solves, and its main capabilities based on your project's code.",
|
|
5
|
-
"path": "/overview",
|
|
6
|
-
"sourceIds": ["README.md", "aigne.yaml", ".aigne/doc-smith/config.yaml"],
|
|
7
|
-
"parentId": ""
|
|
8
|
-
},
|
|
9
|
-
{
|
|
10
|
-
"title": "Getting Started",
|
|
11
|
-
"description": "Provides a step-by-step guide to installing the tool and generating your first set of documents.",
|
|
12
|
-
"path": "/getting-started",
|
|
13
|
-
"sourceIds": ["README.md", "agents/init/index.mjs", "media.md"],
|
|
14
|
-
"parentId": ""
|
|
15
|
-
},
|
|
16
|
-
{
|
|
17
|
-
"title": "Guides",
|
|
18
|
-
"description": "Contains step-by-step instructions for performing common documentation tasks.",
|
|
19
|
-
"path": "/guides",
|
|
20
|
-
"sourceIds": [
|
|
21
|
-
"aigne.yaml",
|
|
22
|
-
"README.md",
|
|
23
|
-
"agents/generate/index.yaml",
|
|
24
|
-
"agents/update/index.yaml",
|
|
25
|
-
"agents/translate/index.yaml",
|
|
26
|
-
"agents/publish/index.yaml",
|
|
27
|
-
"agents/clear/index.yaml",
|
|
28
|
-
"agents/evaluate/index.yaml",
|
|
29
|
-
"agents/history/index.yaml",
|
|
30
|
-
"agents/chat/index.yaml"
|
|
31
|
-
],
|
|
32
|
-
"parentId": ""
|
|
33
|
-
},
|
|
34
|
-
{
|
|
35
|
-
"title": "Configuration",
|
|
36
|
-
"description": "Details how to set up the tool and manage personal preferences for document generation.",
|
|
37
|
-
"path": "/configuration",
|
|
38
|
-
"sourceIds": [
|
|
39
|
-
"aigne.yaml",
|
|
40
|
-
"agents/init/index.mjs",
|
|
41
|
-
"agents/prefs/index.mjs",
|
|
42
|
-
".aigne/doc-smith/config.yaml"
|
|
43
|
-
],
|
|
44
|
-
"parentId": ""
|
|
45
|
-
},
|
|
46
|
-
{
|
|
47
|
-
"title": "Release Notes",
|
|
48
|
-
"description": "Lists new features, improvements, and bug fixes for each version of the tool.",
|
|
49
|
-
"path": "/release-notes",
|
|
50
|
-
"sourceIds": ["CHANGELOG.md"],
|
|
51
|
-
"parentId": ""
|
|
52
|
-
},
|
|
53
|
-
{
|
|
54
|
-
"title": "Generating Documentation",
|
|
55
|
-
"description": "Walks through the process of creating a new set of documents from your source files from start to finish.",
|
|
56
|
-
"path": "/guides/generating-documentation",
|
|
57
|
-
"sourceIds": [
|
|
58
|
-
"agents/generate/index.yaml",
|
|
59
|
-
"agents/generate/generate-structure.yaml",
|
|
60
|
-
"agents/generate/user-review-document-structure.mjs",
|
|
61
|
-
"agents/update/batch-generate-document.yaml",
|
|
62
|
-
"README.md",
|
|
63
|
-
"agents/generate/check-need-generate-structure.mjs",
|
|
64
|
-
"agents/generate/refine-document-structure.yaml",
|
|
65
|
-
"agents/generate/check-document-structure.yaml"
|
|
66
|
-
],
|
|
67
|
-
"parentId": "/guides"
|
|
68
|
-
},
|
|
69
|
-
{
|
|
70
|
-
"title": "Updating Documentation",
|
|
71
|
-
"description": "Explains how to modify existing documents based on code changes or new feedback.",
|
|
72
|
-
"path": "/guides/updating-documentation",
|
|
73
|
-
"sourceIds": [
|
|
74
|
-
"agents/update/index.yaml",
|
|
75
|
-
"agents/update/update-single-document.yaml",
|
|
76
|
-
"agents/update/batch-update-document.yaml",
|
|
77
|
-
"agents/update/user-review-document.mjs",
|
|
78
|
-
"README.md",
|
|
79
|
-
"agents/update/check-update-is-single.mjs",
|
|
80
|
-
"agents/update/handle-document-update.yaml",
|
|
81
|
-
"agents/update/generate-document.yaml"
|
|
82
|
-
],
|
|
83
|
-
"parentId": "/guides"
|
|
84
|
-
},
|
|
85
|
-
{
|
|
86
|
-
"title": "Translating Documentation",
|
|
87
|
-
"description": "Details the steps to translate your documents into multiple supported languages.",
|
|
88
|
-
"path": "/guides/translating-documentation",
|
|
89
|
-
"sourceIds": [
|
|
90
|
-
"agents/translate/index.yaml",
|
|
91
|
-
"agents/translate/translate-multilingual.yaml",
|
|
92
|
-
"agents/translate/choose-language.mjs",
|
|
93
|
-
"README.md",
|
|
94
|
-
"agents/translate/translate-document.yaml",
|
|
95
|
-
"agents/translate/record-translation-history.mjs"
|
|
96
|
-
],
|
|
97
|
-
"parentId": "/guides"
|
|
98
|
-
},
|
|
99
|
-
{
|
|
100
|
-
"title": "Publishing Your Docs",
|
|
101
|
-
"description": "Shows how to make your generated documentation live and accessible online.",
|
|
102
|
-
"path": "/guides/publishing-your-docs",
|
|
103
|
-
"sourceIds": ["agents/publish/index.yaml", "agents/publish/publish-docs.mjs", "README.md"],
|
|
104
|
-
"parentId": "/guides"
|
|
105
|
-
},
|
|
106
|
-
{
|
|
107
|
-
"title": "Initial Setup",
|
|
108
|
-
"description": "Guides you through the interactive setup process to create your initial configuration file.",
|
|
109
|
-
"path": "/configuration/initial-setup",
|
|
110
|
-
"sourceIds": ["agents/init/index.mjs", "README.md", ".aigne/doc-smith/config.yaml"],
|
|
111
|
-
"parentId": "/configuration"
|
|
112
|
-
},
|
|
113
|
-
{
|
|
114
|
-
"title": "Managing Preferences",
|
|
115
|
-
"description": "Explains how to view, remove, and toggle your saved preferences for documentation generation.",
|
|
116
|
-
"path": "/configuration/managing-preferences",
|
|
117
|
-
"sourceIds": ["agents/prefs/index.mjs", "README.md"],
|
|
118
|
-
"parentId": "/configuration"
|
|
119
|
-
},
|
|
120
|
-
{
|
|
121
|
-
"title": "Managing History",
|
|
122
|
-
"description": "Shows how to view the history of updates made to your documentation.",
|
|
123
|
-
"path": "/guides/managing-history",
|
|
124
|
-
"sourceIds": ["agents/history/view.mjs", "aigne.yaml", "agents/history/index.yaml"],
|
|
125
|
-
"parentId": "/guides"
|
|
126
|
-
},
|
|
127
|
-
{
|
|
128
|
-
"title": "Evaluating Documents",
|
|
129
|
-
"description": "Details how to use the evaluation command to assess the quality and completeness of your generated documentation.",
|
|
130
|
-
"path": "/guides/evaluating-documents",
|
|
131
|
-
"sourceIds": [
|
|
132
|
-
"agents/evaluate/index.yaml",
|
|
133
|
-
"aigne.yaml",
|
|
134
|
-
"agents/evaluate/document-structure.yaml",
|
|
135
|
-
"agents/evaluate/document.yaml",
|
|
136
|
-
"agents/evaluate/generate-report.mjs"
|
|
137
|
-
],
|
|
138
|
-
"parentId": "/guides"
|
|
139
|
-
},
|
|
140
|
-
{
|
|
141
|
-
"title": "Cleaning Up",
|
|
142
|
-
"description": "Provides instructions on how to use the clear command to remove generated files, configurations, and cached data.",
|
|
143
|
-
"path": "/guides/cleaning-up",
|
|
144
|
-
"sourceIds": [
|
|
145
|
-
"agents/clear/index.yaml",
|
|
146
|
-
"aigne.yaml",
|
|
147
|
-
"agents/clear/choose-contents.mjs",
|
|
148
|
-
"agents/clear/clear-generated-docs.mjs",
|
|
149
|
-
"agents/clear/clear-document-structure.mjs",
|
|
150
|
-
"agents/clear/clear-document-config.mjs",
|
|
151
|
-
"agents/clear/clear-auth-tokens.mjs"
|
|
152
|
-
],
|
|
153
|
-
"parentId": "/guides"
|
|
154
|
-
},
|
|
155
|
-
{
|
|
156
|
-
"title": "Interactive Chat",
|
|
157
|
-
"description": "Explains how to use the interactive chat assistant to generate, modify, and manage your documentation.",
|
|
158
|
-
"path": "/guides/interactive-chat",
|
|
159
|
-
"sourceIds": ["agents/chat/index.yaml", "aigne.yaml"],
|
|
160
|
-
"parentId": "/guides"
|
|
161
|
-
}
|
|
162
|
-
]
|
|
@@ -1,97 +0,0 @@
|
|
|
1
|
-
rules:
|
|
2
|
-
- id: pref_cbc8005011c08ca0
|
|
3
|
-
active: true
|
|
4
|
-
scope: translation
|
|
5
|
-
rule: In the table titled 'Cleanup Targets', the 'Target' column must retain the original text and should not be translated.
|
|
6
|
-
feedback: Do not translate the Target column in the Cleanup Targets table.
|
|
7
|
-
createdAt: 2025-10-11T13:22:06.529Z
|
|
8
|
-
- id: pref_545cabc521ecd4a5
|
|
9
|
-
active: true
|
|
10
|
-
scope: translation
|
|
11
|
-
rule: The proprietary term 'AIGNE Framework' must not be translated and must be retained in its original form.
|
|
12
|
-
feedback: AIGNE Framework is a proper noun and has its own link; no translation is required.
|
|
13
|
-
createdAt: 2025-10-11T12:26:37.517Z
|
|
14
|
-
- id: pref_6e612d7ca8b7f3b6
|
|
15
|
-
active: true
|
|
16
|
-
scope: document
|
|
17
|
-
rule: When describing publishing options, should use plain text instead of custom components, and recommend users to run
|
|
18
|
-
their own Discuss Kit instance while providing relevant links.
|
|
19
|
-
feedback: "Publishing options should not use custom components: recommend users to run their own Discuss Kit instance in
|
|
20
|
-
the text, and add Discuss Kit related links"
|
|
21
|
-
createdAt: 2025-09-07T02:18:22.237Z
|
|
22
|
-
- id: pref_039b58c47bdf95c9
|
|
23
|
-
active: true
|
|
24
|
-
scope: document
|
|
25
|
-
rule: In the "Prerequisites" section, should briefly introduce Node.js installation, specify using npm instead of pnpm,
|
|
26
|
-
and guide users to the official website for detailed instructions.
|
|
27
|
-
feedback: In the prerequisites section, provide a simple introduction on how to install Node.js, no need to install pnpm
|
|
28
|
-
but use npm instead, guide users to the product official website for detailed installation instructions
|
|
29
|
-
createdAt: 2025-09-07T02:06:39.559Z
|
|
30
|
-
- id: pref_03a45a593f645ce2
|
|
31
|
-
active: true
|
|
32
|
-
scope: document
|
|
33
|
-
rule: When describing Discuss Kit, must clearly state that it is a non-open-source service running on the official
|
|
34
|
-
platform, not a self-hosted instance.
|
|
35
|
-
feedback: "In the core features description about document publishing, show the official platform link, run your own
|
|
36
|
-
Discuss Kit instance, not self-hosted: Discuss Kit is not open source."
|
|
37
|
-
createdAt: 2025-09-07T01:59:12.876Z
|
|
38
|
-
- id: pref_0c239f619329089f
|
|
39
|
-
active: true
|
|
40
|
-
scope: document
|
|
41
|
-
rule: In the core features section, should use plain list format and add descriptions and links for AIGNE Hub and
|
|
42
|
-
Discuss Kit.
|
|
43
|
-
feedback: Core features section should not use custom component lists, change to plain lists, add descriptions and links
|
|
44
|
-
for AIGNE Hub and Discuss Kit to help users understand these two products
|
|
45
|
-
createdAt: 2025-09-07T01:53:22.969Z
|
|
46
|
-
paths:
|
|
47
|
-
- /overview
|
|
48
|
-
- id: pref_4e8aa735b11d8484
|
|
49
|
-
active: true
|
|
50
|
-
scope: document
|
|
51
|
-
rule: In the 'How It Works' document, only show DocSmith implementation details, should not include AIGNE Framework
|
|
52
|
-
information.
|
|
53
|
-
feedback: How it works section does not need to show AIGNE Framework, only need to show DocSmith implementation
|
|
54
|
-
createdAt: 2025-09-06T13:15:10.272Z
|
|
55
|
-
paths:
|
|
56
|
-
- /advanced/how-it-works
|
|
57
|
-
- id: pref_4ad26164f1f4fbf6
|
|
58
|
-
active: true
|
|
59
|
-
scope: document
|
|
60
|
-
rule: When describing multi-language support features, must clearly state support for 12 languages and list two to three
|
|
61
|
-
mainstream languages as examples.
|
|
62
|
-
feedback: Multi-language support related features, clearly support 12 languages, no above statement, and give examples
|
|
63
|
-
of two or three mainstream languages
|
|
64
|
-
createdAt: 2025-09-06T12:55:42.678Z
|
|
65
|
-
- id: pref_c84baec514ca5c60
|
|
66
|
-
active: true
|
|
67
|
-
scope: document
|
|
68
|
-
rule: Core features list must describe product functionality characteristics, not promotional value or importance.
|
|
69
|
-
feedback: Core features list should describe DocSmith's functional characteristics, not describe product importance like
|
|
70
|
-
a promotional brochure
|
|
71
|
-
createdAt: 2025-09-06T12:47:46.583Z
|
|
72
|
-
- id: pref_6da200d8e6fec09e
|
|
73
|
-
active: true
|
|
74
|
-
scope: structure
|
|
75
|
-
rule: Do not generate documentation about contribution guidelines.
|
|
76
|
-
feedback: Remove contribution guidelines related documentation, this content is not ready yet
|
|
77
|
-
createdAt: 2025-08-30T14:46:32.741Z
|
|
78
|
-
- id: pref_8c619b5228f791e5
|
|
79
|
-
active: true
|
|
80
|
-
scope: document
|
|
81
|
-
rule: Do not generate content about Mermaid chart validation, as charts have been changed to use D2.
|
|
82
|
-
feedback: Remove mermaid chart validation related descriptions, charts now use D2
|
|
83
|
-
createdAt: 2025-08-30T14:29:04.068Z
|
|
84
|
-
- id: pref_0e154f58c22329fb
|
|
85
|
-
active: true
|
|
86
|
-
scope: document
|
|
87
|
-
rule: Do not generate documentation content about development commands that are no longer supported.
|
|
88
|
-
feedback: Remove development command related documentation, these development commands are no longer supported
|
|
89
|
-
createdAt: 2025-08-30T14:13:50.446Z
|
|
90
|
-
- id: pref_0112657e4103ba88
|
|
91
|
-
active: true
|
|
92
|
-
scope: structure
|
|
93
|
-
rule: Update documentation structure based on the latest source code, can add new documents and modify document
|
|
94
|
-
dependencies on source code, but prohibit modifying any existing document paths.
|
|
95
|
-
feedback: Update documentation structure based on the latest source code, allow adding new documents and modifying
|
|
96
|
-
document dependencies on source code, cannot modify existing document paths
|
|
97
|
-
createdAt: 2025-08-30T14:03:47.434Z
|