中文文档贡献
中文主文档以代码行为为事实来源。修改页面时:
- 找到对应路由、服务、配置、测试或 UI 文案。
- 在页面
code-evidence注释中记录主要路径。 - 更新
baseline_commit和last_verified。 - 无法唯一确定时使用
TODO(category)HTML 注释,列出现用术语、备选项和决策需求。 - 一项事实只保留一个权威页面,其他页面链接过去。
- 用用户会搜索的标题表达任务或症状。
- 操作页包含前置条件、步骤、成功标志、数据影响和失败处理。
- 更新中文侧栏,避免主页面成为孤儿。
旧 URL 使用 search: false 兼容页,不复制第二份正文。中文落地页和英文文档有独立维护节奏,不应在只修改中文主文档的补丁中顺手改动。
