Marvis 教程什么时候开增量章、什么时候退役

2026-11-16 15:37 更新

补一节还是换一章,看变化改的是事实还是结构。

连载型内容最容易犯的两种错方向相反:一种是每次改动都开新章,目录越铺越长,读者找不到入口;另一种是死守原结构,把新能力塞进旧章节,越塞越拧,最后每节都在自我修正。两种错的共同点是没有区分「变化改了什么」。

变化其实只有三种:改事实、改机制、改结构。改事实是数字、名单、版本变了,结论不变;改机制是新增能力或边界移动,结论变了但分类不变;改结构是分类体系本身变了,原来的章节标题不再成立。三种对应的动作完全不同——改字、补节、换章。

这一节给的就是这三档的判据与阈值。有了它,判断「这次要不要动结构」不再靠感觉,也不用每次开会讨论。

前提与适用

项 说明
适用读者 维护连载教程或产品文档的人;面对频繁版本更新不知道改哪的人;要决定旧章节留还是删的人
事实边界 三档划分与阈值为编辑方法,官方无内容维护说明;版本漂移数字仅有第三方来源,不能当官方口径
版本基线 客户端 1.60.3400.35;官方无更新日志,版本变化只能靠零星线索与自己记录
不适用 想知道具体哪一页该回查——见官方页改版回查;想知道版本与变更怎么记——见版本基线与变更记录

怎么做

第一步:判断变化落在哪一档。

三个问题按顺序问,先问到的就是答案:

问一:原来的结论还成立吗? 成立 → 改事实档。不成立 → 往下问。

问二:分类还成立吗? 成立 → 改机制档(补节)。不成立 → 改结构档(换章)。

举例说明这三档的分界。配置门槛从四核改成六核,结论「不达标会慢」仍然成立,只是数字变了 → 改事实。新增一个端(比如鸿蒙),原来「四端」的分类变成「五端」,但分类逻辑(按端划能力)没变 → 改机制,补一节或在矩阵里加一列。如果哪天产品把「端」这个维度改成了「场景」维度,原来按端组织的三章全部不成立 → 改结构。

第二步:用三个阈值决定动不动结构。

判断不能只靠「感觉结构不行了」,给三个可数的阈值:

阈值一:同一节里要改的事实超过三处。 到三处以上,这一节的论证链条通常已经断了——不是某个数字过期,而是整节建立在旧事实上。这时改字不如整节重写,但重写不等于换章,结构可以不动。

阈值二:一个新东西影响三节以上。 新增一个端、一种模式、一类动作,如果需要改三节以上的正文才能说清,就不该散着改,应开一个增量节集中讲,其余各节只留一句指引。散改的后果是同一件事在五处各说一半,读者拼不起来。

阈值三:某节的前提被推翻。 这一条最硬。比如「Mac 上本地模式不可用」这个前提一旦不成立,凡是依赖它的判断(断网验证只在 Windows 成立、Mac 不能断网用)全部失效。这时不是补节,是那一节要退役重写。

第三步:判断该不该退役。

退役比补节更需要理由,因为删掉的东西不会自己回来。四条判据,命中两条以上再考虑退役:

结论错误率过半。 一节里的判断有过半已经错了,修补成本高于重写。

被新节完全覆盖。 新节写完之后,旧节没有独立信息量,只是换个说法重复。

读者对象消失。 比如某一节写给「还没有客户端的人」,而现在产品已全量开放、不再需要邀请码——这一节的场景前提不存在了。这类节最容易变成「历史上曾经有用」的说明,留着只会让新读者困惑。

指向它的入口已经断掉。 目录里没有它、其他节不再引用它、搜索词也变了。孤立的一节即使内容没错,也在消耗维护成本。

第四步:退役要留痕,不要直接删。

处理方式三件套:

标记失效,写明日期与原因。 失效标记要写在正文开头,不能只在变更记录里写。读者是从搜索进来的,看不到你的变更记录。

指向替代。 失效节必须给出「现在该看哪一节」。没有替代说明的失效标记等于死胡同,读者的下一步是关页面。

保留历史内容,不删正文。 旧内容对两类人有用:正在用旧版本的人,以及要理解「为什么以前的说法是这样」的人。删掉之后,这两类问题都无处可查。

这三条合起来的效果是:旧节从「可操作指南」降级为「历史说明」,仍然可读,但不会误导。

第五步:把三档排进固定节奏,别随改随动。

结构改动最怕的不是改错,是随时改。今天动一章、下周动一节,目录一直在变,读者刚收藏的地址失效,内链也跟不上。所以三档要配节奏:

改事实随时做。 数字、名单、版本这类修补不用等窗口,看到就改,改完在变更记录里加一行。这类改动不影响结构,风险最低。

补节按月做。 攒到月底统一补,一次补一到两节。攒的理由是:单次变化往往看不出影响面,两三周后回看才发现「这个东西影响三节」。当场补容易补得零碎,事后补能一次补全。

换章只在两个窗口做。 一是客户端大版本升级之后,二是季度末。前者是因为大版本往往带来成批变化,一次动完比反复动省事;后者是给结构改动一个固定的期望时间,避免它随时插队。

这个节奏还解决一个心理问题:发现「结构好像不行了」的时候,你有个明确去处——记进待办,季度末统一判断。不记的话,这个念头会在每次写稿时重新出现一次,每次都消耗一点注意力,却始终不落地。

节奏定下来之后还有一个好处:结构改动的评估可以一次看全。季度末把攒下的待办摊开,能看出哪几条其实是同一件事的不同侧面——当场判断时看不出来,攒着看就一目了然。

参数与边界

项 说明
三档的判定顺序 必须先问「结论还成立吗」,再问「分类还成立吗」。顺序反了会把改事实误判成改结构,因为任何变化看起来都像结构问题
阈值的性质 三个阈值是编辑经验值,不是行业标准。团队可按自己的更新频率调整,但要固定下来,否则每次都要重新讨论
版本漂移的速度 有第三方资讯称该产品半年内已累计交付二十余个版本,官方三层源未见版本总数。这个数字只能当背景,不能用来推算「多久要重构一次」
不覆盖待实机章节 依赖实机的章节(要截图、要报耗时的那类)在实机到位前不适用本节的退役判据,它们的首要问题是补证据
退役不等于删除 本节所有退役动作都指标记与降级,不含删正文。删除只适用于从未发布过的草稿

验收清单

# 核对项 通过标准 不合格时
1 变化已归档 能明确说出属于改事实、改机制、改结构三档中的哪一档 回到三问逐条回答,答不出说明还没查清变化范围
2 阈值有具体计数 能报出「几处事实」「影响几节」,不是「感觉挺多」 列出待改清单再数;数不出来就先列清单
3 结构决定有依据 动结构的决定能指到某个阈值或某条前提被推翻 拿不出依据就不动结构,先按改事实处理
4 退役节有三件套 失效标记、替代指引、保留正文,三项都在 缺替代指引的不得标失效,否则读者无路可走
5 入口同步 目录、内链、元信息与该节的实际状态一致 逐个改;先改目录,再改内链,最后改元信息

失败与回滚

现象 原因判据 重试或恢复 手动兜底
同一件事在五节里各说一半 变化影响面超过三节却选择散改,没开增量节 收拢到一个增量节,其余各节改为一句指引 先列出这五处的位置,再决定收拢到哪一节
目录越铺越长,读者找不到入口 把每次改动都当成结构变化,节数增长快于内容增长 回退到三档判据,把可合并的节合并 按「一个问题一节点」重排目录,合并同义节
旧节仍被搜索带到,内容已错 退役只改了目录没标失效,或标了失效没留替代 补失效标记与替代指引,放在正文开头 在正文首段加一句「本节描述的是某版本之前的状态」
新节写完了,旧节没处理 只做加法不做减法,两节并存互相矛盾 二选一:合并或降级。不能并存 把旧节降级为历史说明,并交叉引用新节
按阈值动了结构,结果发现只是事实变化 第一问顺序错,先看了分类再判结论 立即回退结构改动,按改事实重做 保持原有章号不变,避免内链大面积失效
内链指向已退役的节 入口没同步,只改了正文 逐个改内链;改完跑一遍链接检查 暂时把内链改为指向新节的上一级目录,保证可达

自检题

# 问题 参考答案要点
1 新增一个端,该补节还是重写全部平台章节 补节。分类逻辑(按端划能力)未变,属改机制档;重写会带来大面积内链失效
2 一节里五处数字都过期了,要换章吗 不一定。五处过期说明该节要整节重写,但结构可以不动——重写与换章是两件事
3 退役的节为什么不能直接删 旧版本用户与想理解历史表述的人还需要它;删了之后这两类问题无处可查,且外链会断

注意与相关

Note:三档里最容易被误判的是「改结构」。因为任何变化在刚发生时看起来都很重要,而「重要」常被翻译成「要重构」。判断办法很朴素:如果原来的分类还能把新东西装进去,就不是结构问题。

Warning:不要在同一个版本周期里既动结构又大量改事实。两件事叠在一起,出问题时无法判断是结构改错还是事实改错,回滚也会连带把正确的部分一起丢掉。

Tip:把三个阈值写进变更记录的模板里,作为必填栏。填的时候必须报数——报不出数就说明这次判断是凭感觉,而凭感觉做的结构改动,三个月后通常要再改一次。

相关:12.1 版本基线和变更记录怎么留(变化怎么记下来)、12.2 官方页改版了该回查哪几处(变化从哪发现)、11.3 数字、型号和额度怎么标证据(数字类变化怎么标出处)。

以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号