选择与主题相符的示例,核心判断标准只有一条:这个例子能否让读者更准确地理解或使用正文里的结论。能直接支撑论点的例子优先保留;只能证明你见多识广、却与结论无关的例子,即使真实有趣,也应当删掉或移到别处。网站内容质量不取决于例子数量,而取决于例子与主张之间的对应关系是否清楚。
从最终页面要交付什么倒推,比先收集素材再想怎么用更省时间。假设你要交付的是一段“如何判断某类操作是否完成”的说明,那么必需的资料是判断标准、可观察的现象,以及一个能展示判断过程的短例子。此时一个平淡但步骤完整的例子,比三个精彩但只展示结果的例子更有用。
可以按下面的顺序确定需要什么:
这样做的结果是,例子数量由卡点数量决定,而不是由你手头素材多少决定。时间和人手有限时,优先处理卡点最多的小节。
拿到一个候选例子后,逐项核对:
判断结果分三种:三项都通过,直接使用;只有对应关系通过,降级为辅助说明;对应关系不通过,无论多生动都删除。这里的“通过”不需要复杂评审,一个了解该主题的人花几分钟就能判断。
假设你要说明“同一段文字在不同位置出现,读者理解会不同”。
选法一:举一个知名品牌的广告语,说明它放在首页和放在文末效果不同。这个例子的问题在于,读者无法验证效果差异,而且品牌广告语本身带有大量背景信息,容易把讨论带偏。
选法二:自己构造两段相同文字,一段放在结论之前,一段放在结论之后,分别写出读者可能产生的两种理解。这个例子条件清楚、可以复现,读者照着改一改就能用在自己页面上。
选法二更符合主题,因为它把“位置影响理解”这个结论直接展示出来,而不依赖外部案例的知名度。这里的例子是假设,用于说明选择方法,不代表任何真实项目结果。
时间和人手有限时,最容易出问题的是例子由谁负责核实。可行做法是:写正文的人负责提出例子并标注它对应哪个结论;另一个人只做一项检查,即这个例子是否支持该结论。两人不必反复讨论例子好不好看。
验收时看三个点:
如果一项内容同时出现多个例子却只支撑同一个结论,保留可验证程度最高的那个,其余删除或合并。这一步通常能明显缩短页面,同时不损失信息。
先挑出页面中承担主要结论的段落,逐个检查它们是否配有对应例子;没有例子的补一个最简例子,例子与结论对不上的直接删除。把这项检查限制在最重要的三到五个段落内,完成后再决定是否扩展到全文。