一篇一个判断
这个站不是资讯站,也不是课程。它面向一个具体问题,给一个能执行的答案。 所以每一篇都得长成同一个形状。
五个部分,顺序固定
01一句话
30 字内给出结论,必须是判断,不是描述。写不出判断,说明还没想清楚。
02正面讲清
先解释「为什么是这样」,而不是罗列「有哪些」。
03可操作
给规则、表格、判据、代码。读者看完能直接动手。
04反例
写清楚最常见的错法,以及错在哪一步。
05依据
结论挂得住:法规条文、清算规则、真实报文、可跑的代码。
结构先于文字
先有坐标表,再填内容。12 个域、106 个子域、774 个节点是先把「支付这件事包含什么」拆完, 才允许动笔。好处是:任何一篇都能定位到它的上下位,读者不会读到一半掉进另一个话题; 坏处是:看上去永远没写完——因为确实还没写完。
12
域
顶层分类 A–L
106
子域
域内的能力块
774
节点
最小知识单元 = 一篇
发布前的五个问题
- 1这句话能被反驳吗?不能被反驳就不是判断。
- 2有没有一个数字、表格或代码块?没有就是空谈。
- 3读者照做会不会踩坑?坑写出来了没有?
- 4和相邻节点的边界清楚吗?不清楚就会重复。
- 5结论过期了吗?过期要标,不能装作还成立。
缺口公开
每页都显示「已写 / 总数」。没写的节点照样列出来,标成待写。 一个知识库最怕的不是缺内容,是读者不知道哪里缺。