资料页上线前的六项核对
资料页不像文章,写完就完;它会被反复查阅、被别人引用,一个小错误会留很久。我固定用六项核对,上线前逐条过一遍,只答“是/否/待确认”。
六项
一、来源是否齐全。 每条关键信息有没有对应链接,链接能否打开。没有出处的结论一律先撤下。
二、版本与日期是否标注。 结论适用于哪个版本、什么时候核对过。缺了这两项,半年后没人敢用。写法可参考 BackendWiki 把参数与适用版本列清的方式。
三、字段是否一致。 同类条目用同一套字段和取值,别一处写“已开启”、另一处写“开放中”。取值不统一,后面就没法筛选。
四、边界是否写明。 哪些情况不适用、哪些信息尚未确认。定义与边界的写法,Layui 镜像站那种克制表述 很值得借鉴。
五、链接与页面结构。 内链是否可达、目录与页面是否对应、站点地图是否包含新页。把结构放进生成环节更稳,HTML 入门教程站的 sitemap 实践 讲得清楚。
六、回退是否可行。 改前的版本有没有留存、出问题多久能恢复。资料页常被多人编辑,没有回退就等于没有保险。
怎么用
六项做成一张固定表,每次只填日期和判定,不写评语。出现“待确认”就不上线,把它抄进待办并指定人。清单的作用是把没做完的事显式留下,而不是打完勾就归档。
批量核对链接与字段可以用 WorkBuddy 按规则跑一遍初筛,但边界与适用性仍要人看;编排方式见 WorkBuddy 官方文档。
小结
资料页的质量不取决于写得多全,而取决于别人敢不敢直接用。六项核对花十几分钟,换来的正是这份“敢用”。