用WorkBuddy生成活动更新diff:只列变化项
问题
同一份活动说明会更新好几轮:时间延长、条件微调、奖励补一条。以前每次更新都把整段重新贴一遍,读者得自己找改了哪里,也容易漏看。后来改成只输出 diff——一份只列变化项的清单。
结构怎么定
每条变化固定五列:
| 列 | 内容 |
|---|---|
| 字段 | 时间 / 条件 / 奖励 / 适用范围 |
| 旧值 | 上一版的原文短句 |
| 新值 | 这一版的原文短句 |
| 变更类型 | 新增 / 修改 / 删除 |
| 影响判断 | 是否影响已参与的人 |
第五列是给读者看的,也是这份清单真正的价值:不是告诉人“改了”,而是告诉他“要不要因此做点什么”。
WorkBuddy 做什么
- 按固定字段比对本轮与上一轮,只输出值不同的行,相同的字段全部略过;
- 把纯措辞调整(换了个说法、加了个标点)单独标为“无实质变化”,不混进 diff;
- 生成一段三行摘要:改了几处、哪类字段、是否有影响已参与者的变更。
第 2 步很重要。不加这一层,每次都会冒出一堆无关紧要的文字差异,读者很快就懒得看了。规则要按字面判定,别让它猜语义;字段与取值怎么定,参考 BackendWiki 的表格化写法。
把比对固定成每次更新后跑一遍,可参考 WorkBuddy 官方文档 的编排说明。清单本身用纯静态页放着,HTML 入门教程站的思路 足够。
结果
原来一整段的更新公告,现在通常只剩两三行。读者扫一眼就知道该不该调整安排,重复提问明显少了。
复盘
信息不是越多越清楚,重复的部分会稀释变化的部分。 把不变的全部略过,只留变化项和影响判断,读者才愿意每次都认真看一眼。