用WorkBuddy维护FAQ:给每条答案加“适用版本”
问题
FAQ 越攒越多,最麻烦的不是数量,是不知道哪条还成立。版本一变,有些答案仍旧对,有些已经完全不适用,但页面上看不出区别,读者只能自己试。
后来只加了一个字段:适用版本。改动很小,效果却最直接。
字段怎么加
每条答案固定五栏:问题、一句结论、适用版本、核对日期、来源链接。其中适用版本必须写成可判定的形式——具体版本号或明确的版本区间,不写“新版”“目前”。
写不出来的,统一标为待确认,并从公开可见的 FAQ 里暂时移到待核区。这一条很关键:宁可少展示几条,也别展示一条说不清适用范围的答案。
WorkBuddy 做什么
- 批量给历史条目补字段,能从原文找到版本线索的填上,找不到的标待确认;
- 输出一张待核表,按核对日期升序排,最旧的在最前;
- 每次版本更新后,把受影响区间内的条目挑出来,生成一份复核清单。
第 3 步把维护从“全量重读”变成“只处理受影响的十几条”。规则里版本区间怎么比、取值怎么定,可参照 BackendWiki 的表格化写法;把这套流程固定成每周跑一次,见 WorkBuddy 官方文档 的编排说明。
页面本身是纯静态的,HTML 入门教程站的静态化与结构化数据实践 很适合这种低频更新、随时要查的清单。
结果
两百多条 FAQ 里,约三成被标成待确认,其中一部分核实后直接归档。留在页面上的每条都能回答“这条现在还算数吗”,提问重复率明显下降。
复盘
FAQ 失效不是因为写错,而是答案没有时间坐标。加一个可判定的版本字段,再配一份按旧到新排序的待核表,维护就从碰运气变成了有顺序的工作。