2.5 KiB
2.5 KiB
当前文档的应用评估
评估对象：语言文档基线提交 a33f809。方法：作者按本手册进行结构与内容自查，未进行真实用户实验或语言执行测试。
已具备的组织
| 项目 | 对应规则 | 基线情况 |
|---|---|---|
| 概念依赖顺序 | DOC-005 | 身份与 namespace 在程序结构、语法及应用之前 |
| 独立查询主题 | DOC-006、007 | 类、表达式、函数、数据和 UI 分章，附录集中参考 |
| 明确语法状态 | DOC-015 | 入口与附录说明设计稿，get 和官方引用保留局部说明 |
| 跨 namespace 语义 | DOC-013、016 | 参数、结果与数据依赖不绑定协议实现 |
| 连续业务背景 | DOC-011 | 商品与定价贯穿主要例子 |
| 术语与记法 | DOC-017 | Preflight、inflight 和外部归属统一展示 |
以上只记录观察到的组织，不表示全部规则已完美满足。
优先改进项目
A-01 增加明确的读者目标
读者背景与每章阅读后的能力仍可更具体。后续优先为首页说明适合谁、需要哪些基础，以及设计稿不等于可执行教程。适用规则：DOC-001、003、004。
A-02 完善示例闭环
数据读取等章节虽然说明预期效果，但并非所有关键例子都有同等清晰的输入和核对点。可补充成功路径的确定输入与结果，同时保留 get 的提案状态。适用规则：DOC-009、010、015。
A-03 补充边界用法的解释
函数参数数量、类型和单根规则已有说明，仍可用更一致的“原因—诊断阶段—修正思路”组织。未确定的错误处理语法不能补造。适用规则：DOC-012、013。
A-04 支持真正的跳转阅读
检查从术语表或文法直接进入类、调用和 UI 页时，是否拥有足够的局部条件。对未定义成员或官方来源保留短注，但减少对其他章节的强记忆依赖。适用规则：DOC-004、007、008。
A-05 验证理解而非只验证格式
让未参与设计的人尝试复述定位与调用模型、寻找 use 规则并预测组合函数结果；记录卡住的位置。当前只具备作者自查，不能宣称读者测试通过。适用规则：DOC-024。
本轮边界
本轮建立手册、模板和维护流程，不自动根据上述评估改写语言正文，不将任何提案确认成最终规范。后续每个应用项目分别修改与验证，保留可审查的差异。