把重复说明提取到公共页面,前提是这段说明在多个页面里承担同样的解释职责;如果各页对它的依赖方式不同,提取后必须补回上下文,否则读者会看到一段正确但无法判断适用范围的说明。判断标准很简单:删掉原位置那段文字后,读者是否仍能知道“这条规则适用于谁、在什么条件下适用”。做不到就保留原页的局部说明,只把最通用的部分抽走。
同一职责的重复,指多个页面都在回答同一个前置问题,例如“这类服务是否支持变更”“这类费用在什么情况下产生”。这种内容适合提取到公共页面,因为它的解释对象一致。同一措辞的重复则不同:文字看起来一样,但每页读者带着不同任务进来,需要的落点也不同。
区分方法是对每个原页面问三个问题:这段说明出现的位置在正文前段还是决策点附近;读者读完后紧接着要做什么;删掉它之后,页面上的操作步骤是否仍然成立。如果三个答案在各页明显不同,提取时就不能只搬文字,而要在公共页面上分条件写清楚,再在原页面留下指向具体条件的短句。
当这段说明同时承担解释和判断依据,且各页的判断结果不一致时,保留原文更稳妥。比如同一类业务在不同地区、不同套餐下的适用规则不同,公共页面只能给出总则,原页面仍需要写出本页对应的那一条。
实际操作是:公共页面写完整规则,原页面保留一句本页结论,并链接到公共页面看依据。动作结果是读者先看到结论,再决定是否深读规则;后续维护时,规则变化只需改公共页面,原页面的结论句需要人工复核,这一步不能省。
这是最常见的做法。公共页面只保留不随页面变化的定义、范围和例外类型;原页面改成一句带条件的引用,例如“本页所述情形属于公共页面中的第二类,因此按该类的步骤执行”。
改写的关键不是删字,而是补回三个要素:适用对象、触发条件、下一步动作。缺少其中任何一个,读者就要跳回公共页面自己推断,提取反而增加了阅读成本。假设一个页面原本用两百字解释某类请求的处理顺序,提取后公共页面写通用顺序,原页面只留“本页属于需要先确认再提交的类型,顺序见公共页面”。如果该页读者多数已经知道自己的类型,这样写可以;如果多数人不知道自己属于哪类,就要在原页面保留一句判断依据。
当各页说明虽然相似,但背后对应不同的责任方、不同的时效或不同的例外清单时,强行合并会制造错误。此时应退出提取,让各页自行维护,只在公共页面放一份索引,标明哪些页面存在差异。
退出的信号包括:每次同步公共页面都要为某个页面开例外;原页面读者需要的是本页专属的时限或范围;合并后必须加大量“视情况而定”才能成立。出现这些信号时,继续提取的维护成本会高于重复本身。
验证不靠感觉,靠一次可复现的检查。挑三到五个原页面,遮住公共页面,只读原页面的剩余文字,看是否还能回答“这条说明和我有什么关系”。如果读不出来,说明引用句太薄。
接着检查公共页面自身:它是否把不同条件分开写,而不是把多个条件揉成一段。条件混写的公共页面会让所有引用它的页面都变得含糊。最后检查链接文字:不要用“点击这里”“详见”,而要写出目标内容的范围,让读者在点击前就知道会看到什么。
比较改动前后的数据时要注意,流量或点击的变化可能来自季节、搜索需求波动或数据采集口径差异,不能单独归因于这次提取。更可靠的观察是:原页面停留和继续点击的行为是否更集中,读者是否还在反复回到公共页面寻找同一条件。
假设三个页面都在解释“提交后多久可以修改”。公共页面写通用规则:提交后进入处理阶段,处理阶段内的修改按类型区分。原页面A的读者多在提交前,保留一句“本页操作在提交前完成,提交后按公共页面的处理阶段规则”。原页面B的读者多在提交后,保留“本页属于处理阶段内修改,先看公共页面的类型判断,再回到本页执行”。原页面C涉及特殊时限,不提取,自行维护,并在公共页面索引中标注差异。
这个例子里,A和B改写后仍能独立判断下一步,C退出后不会污染公共规则。判断是否成功的标准是:读者不打开公共页面也能知道自己的位置,打开后能直接找到对应条件,而不是从头读一遍。
提取重复说明的目标不是让页面变短,而是让每条说明都落在读者能做决定的位置上;只要原页面还能回答适用范围和下一步,提取就是成立的,否则应保留、改写或退出,而不是为了统一而牺牲上下文。