Markdown 很容易写,难的是让它在项目变大之后仍然好找、好读,也能看清每次修改从哪里来。很多团队已经把说明、手册和决策记录放在 Git 仓库里,却还要额外维护一套文档后台。
软件行业有一种很熟悉的幻觉:把一个简单的数学运算,层层包成六层间接调用的大教堂,然后再假装这叫“工程化”。