Skip to content

Commit a4c070d

Browse files
committed
fix(docs): multi-audience user+contributing and unreleased changelog
Treat 用户文档 with 贡献指南 as multi-audience split, and repair the corrupted unreleased docs-audience changelog entry with cognitive-altitude notes.
1 parent dd16c72 commit a4c070d

3 files changed

Lines changed: 10 additions & 4 deletions

File tree

‎changelogs/unreleased.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -125,5 +125,5 @@ WorkspaceDataAbsorptionScopeGate · DocsSiteVisualAcceptanceGate · OmissionOnly
125125
- 需求:`.devcodex/devcodex-v1/requirements/控制面闭合证据与误放行治理/`。
126126

127127
## 2026-07-24
128-
- **[docs-audience]** DocsAudienceIntentGate + user/maintainer site authoring split;
129-
pm run test:docs-audience`n
128+
- **[docs-audience]** DocsAudienceIntentGate + user/maintainer site authoring split;`npm run test:docs-audience`。
129+
- **[docs-cognitive-altitude]** 用户站 guide 任务语言/认知高度;禁止函数清单式 quick start;问题驱动场景延展(intent);复审修复「用户文档+贡献指南」须 multi-audience。

‎scripts/lib/docs-audience-intent.js‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,8 +29,9 @@ function classifyDocsAudienceSample(prompt, opts = {}) {
2929
const blob = `${text}\n${pathBlob}`
3030
const signals = []
3131

32-
const hasUserPhrase = /用户使用|使用文档|安装|quick\s*start|快速开始|接入|给使用者|开源用户|第一次成功|how to use|getting started/i.test(blob)
33-
const hasMaintPhrase = /维护者|贡献|contributing|本地开发|clone|发版\s*runbook|release\s*checklist|internals|ADR|开发站点|给维护/i.test(blob)
32+
const hasUserPhrase = /用户使用|用户文档|使用文档|使用者文档|安装|quick\s*start|快速开始|接入|给使用者|开源用户|第一次成功|how to use|getting started/i.test(blob)
33+
// 贡献 alone is weak; prefer contributing/维护者/开发站 to avoid over-fire, but 贡献指南 is maintainer
34+
const hasMaintPhrase = /维护者|贡献指南|贡献流程|contributing|本地开发|clone|发版\s*runbook|release\s*checklist|internals|ADR|开发站点|给维护|维护者文档/i.test(blob)
3435
const hasReadme = /\bREADME\b|主入口文档/i.test(blob)
3536
const hasReference = /\bAPI\b|CLI|Config\s*参考|接口参考|reference/i.test(blob)
3637
const hasMigrationUser = /升级指南|迁移指南|从\s*v?\d|upgrade\s+guide/i.test(blob) && !/实现迁移|迁移代码|写迁移/i.test(blob)

‎scripts/test-docs-audience-intent.js‎

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -65,6 +65,11 @@ const {
6565
assert.strictEqual(r.docsAudience, 'multi-audience')
6666
assert.strictEqual(r.failClosed, true)
6767
}
68+
{
69+
const r = classifyDocsAudienceSample('写用户文档和贡献指南')
70+
assert.strictEqual(r.docsAudience, 'multi-audience', 'user doc + contributing guide must split')
71+
assert.strictEqual(r.failClosed, true)
72+
}
6873

6974
// Disambiguation must carry unique recommendation
7075
{

0 commit comments

Comments
 (0)