Files
marqdo/doc/roadmap/code-as-docs-gaps.md
T
cflmy 9331af78e2 release(2.8.0): 合入 CHANGELOG/README/发版说明/skills prove 任务;CI 链接指向 doc/releases
- CHANGELOG.md:v2.8.0 条目(中英双语);
- README.md:版本行 2.7.1→2.8.0 + 愿景第 6 条(知识可证明);
- doc/releases/v2.8.0.md:双语发版说明(亮点/用法/已知限制);
- skills/marqdo-dev/index.mq.md:新增 prove 任务(路径/目录模式/
  require_lean/json;参数用 + 行声明升参,check 与 narrative-ratio 通过);
- 设计文档 §12.5 标记已合入;发版链接统一指向 doc/releases/v2.8.0.md。
2026-11-18 10:29:26 +08:00

1.9 KiB
Executable File
Raw Blame History

路线图:代码即文档叙述面摩擦(G1–G4)

状态 Done(实现已合入工作树;金样绿)
日期 2026-09-14
设计 code-as-docs-gaps.md
样例 examples/code-as-docs/index.mq.md

里程碑

M1 — 文档与金样夹具

  • 设计文档记录 G1–G4 与启发式
  • 本路线图
  • tests/markup-v03/ 四缝金样 + gold.rs markup_v03_*

M2 — G1 模块级 ---

  • parse_classified:顶层 frame 行 skip;顶层 Comment 引言 skip
  • 函数体内 --- / *** 改为叙述跳过(不再收束;空返回收束)
  • 金样:module-hr.mq.md

M3 — G3 浮点面量与运算

  • Literal::Num(f64)
  • parse_primary 识别 digits.digits(及 .5 / 3. 形态)
  • eval_binary + bytecode Int/Num 提升(Int/Int / 仍为整除)
  • 金样:float-discount.mq.md

M4 — G2 叙述强调启发式

  • scan_prose_line:非代码形粗体、非返回形行内斜体 → 丢弃
  • 保持 **n=n+1**、**加一 37**、整行 *n*、「返回n」
  • 更新 Skill:允许装饰性强调;可执行仍看形状
  • 金样:soft-emphasis.mq.md

M5 — G4 动态脚注键

  • AST:IndexKey::{Lit,Var}([^`ident`])
  • 解析、求值、bytecode
  • 金样:dynamic-footnote.mq.md
  • 回写 examples/code-as-docs(浮点折扣 + 动态键)

M6 — 出门

  • examples/code-as-docs 展示四缝修复后的写法
  • cargo test --test gold 绿
  • 设计验收覆盖(见金样)

顺序建议

G1(小)→ G3(中,Literal/运算)→ G2(启发式,依赖金样钉行为)→ G4(AST 面)→ 回写样例。


修订历史

日期 说明
2026-09-14 初稿
2026-09-14 实现完成并勾选