用WorkBuddy生成活动更新diff:只列变化项

用WorkBuddy生成活动更新diff:只列变化项

问题

同一份活动说明会更新好几轮:时间延长、条件微调、奖励补一条。以前每次更新都把整段重新贴一遍,读者得自己找改了哪里,也容易漏看。后来改成只输出 diff——一份只列变化项的清单。

结构怎么定

每条变化固定五列:

列内容
字段时间 / 条件 / 奖励 / 适用范围
旧值上一版的原文短句
新值这一版的原文短句
变更类型新增 / 修改 / 删除
影响判断是否影响已参与的人

第五列是给读者看的,也是这份清单真正的价值:不是告诉人“改了”,而是告诉他“要不要因此做点什么”。

WorkBuddy 做什么

  1. 按固定字段比对本轮与上一轮,只输出值不同的行,相同的字段全部略过;
  2. 把纯措辞调整(换了个说法、加了个标点)单独标为“无实质变化”,不混进 diff;
  3. 生成一段三行摘要:改了几处、哪类字段、是否有影响已参与者的变更。

第 2 步很重要。不加这一层,每次都会冒出一堆无关紧要的文字差异,读者很快就懒得看了。规则要按字面判定,别让它猜语义;字段与取值怎么定,参考 BackendWiki 的表格化写法。

把比对固定成每次更新后跑一遍,可参考 WorkBuddy 官方文档 的编排说明。清单本身用纯静态页放着,HTML 入门教程站的思路 足够。

结果

原来一整段的更新公告,现在通常只剩两三行。读者扫一眼就知道该不该调整安排,重复提问明显少了。

复盘

信息不是越多越清楚,重复的部分会稀释变化的部分。 把不变的全部略过,只留变化项和影响判断,读者才愿意每次都认真看一眼。