Files
STM32F4-Base/.dsh
wandering1 de6d5d863a docs(cfg): 配置设计档补示例文件一章,写作规范补单篇自洽原则
配置文件设计.md 增加第 2 章「一份完整示例文件」:给出首启模板全文
(8 段 46 键,值全部对照工厂默认宏核对),再按段拆成 2.1~2.6 六张
键表(键 / 类型 / 出厂值 / 含义 + 生效时机),读者不必再翻别的文档
才能知道每个段的键是什么意思。

为保持文档自洽顺带收敛:
- 删掉文件格式章里重复的文件头代码块,改为指向第 2 章
- 删掉段表下「默认值见网络配置说明」的跳转,默认值现就在本篇
- 相关文档里把网络配置说明降级为对外使用手册
- 后续章号整体后移一位,交叉引用同步校准

doc-writer 角色补写作原则:原「同一事实只写一次」只覆盖跨篇去重,
照字面执行会逼出一篇到处跳转的文档。改为明确两条的分工——同一篇内
求完整、篇与篇之间求唯一,并给出判断标准(读者会不会被逼着另开一篇
才能读懂)与常见取舍。反模式表同步加一行。

验证:48 个提交期钩子全通过;check_doc_links / check_mermaid 通过。
2026-11-15 21:10:21 +08:00
..