直接回答:不能把重复说明整段搬到公共页面就了事,正确做法是先判断这段说明是“可独立引用的知识块”还是“依赖前后文的过渡块”。前者可以提取,后者只能保留在主页面或做条件化引用。判断依据是:去掉上下文后,读者能否在不跳转的情况下理解结论,以及公共页面能否承载多产品之间的差异。
结论型重复指多个页面都在说同一个事实,比如“该字段为空时表示不限制范围”。这种内容适合提取到公共页面,因为它在任何页面里的含义都不变。过程型重复指多个页面都在描述同一套操作步骤,但每一步都依赖当前页面的前置条件,比如“先复制上一节的参数,再填入当前表单”。这种内容提取后会丢失“上一节”指向什么,读者必须回跳才能理解。
选择依据可以简化成一句话:去掉当前页面标题后,这段话还能被独立理解吗?能,就归入可提取;不能,就归入需保留。实际操作时,把候选段落逐条复制到一个空白文档里,删掉页面标题和相邻段落,再读一遍。读不通的段落就是过程型重复,不要动它。
当多个页面重复的是同一套定义、同一组限制条件或同一张对照关系,且各页面之间没有实质性差异时,提取到公共页面是成立的。动作是:在公共页面写完整说明,在原页面保留一句摘要,并给出指向公共页面具体小节的锚点链接。
结果是:原页面变短,读者仍能从摘要判断是否需要深入。下一步要检查的是,摘要句是否包含该页面特有的限定词。例如公共页面写“超时时间默认为30秒”,原页面如果实际配置不同,摘要就必须写成“本页使用自定义超时,默认值见公共说明”,否则读者会把公共默认值误当成当前页面的实际值。
这种做法的边界是:公共页面一旦被修改,所有引用它的页面含义都会随之变化。因此公共页面里不要写“当前产品”“本页面”这类指向不明的词,全部改成具体对象名称。
当重复说明不只是陈述事实,还负责把上文和下文连起来时,直接提取会制造断裂。典型信号是:这段说明里出现“因此”“接下来”“与上一项配合”等连接词,或者它解释了为什么当前页面要采用某个参数。
这时不要提取整段,而是拆成两层:公共页面只保留可复用的事实部分,原页面保留连接和理由部分。动作是:把事实句移入公共页面,原页面用一句话说明“本页为何采用该事实”,并链接到公共页面对应小节。
结果如何影响下一步:如果拆完后原页面的连接句仍然需要读者先读公共页面才能理解,说明拆分位置选错了,应把连接句也留在原页面,只把最独立的那一句事实移走。判断标准是,读者不点链接也能顺畅读完原页面。
假设某产品有三个配置页面,都重复说明“批量操作会忽略空值”。其中页面A的批量操作会额外触发校验,页面B不会,页面C的批量操作入口被隐藏。此时公共页面可以写“批量操作对空值的通用处理是忽略”,但三个页面必须各自补充自己的例外。
如果直接把公共说明整段替换掉三个页面的原文,页面A的读者会以为校验不存在,页面C的读者会找不到入口说明。正确动作是:公共页面只保留通用规则,三个页面各留一句“本页批量操作是否触发校验”“本页入口是否可见”。这样公共页面不会因为个别页面的例外而变得臃肿,个别页面也不会丢失自己的前提。
如果这三项中有一项不成立,先回退到拆分位置调整,而不是继续扩大提取范围。提取的目的是减少重复维护,不是把上下文一并删掉。只有当公共页面能独立成立、原页面摘要能标明差异、读者不跳转也能读完当前页时,这次提取才算保留了上下文。