设备卖到海外,安装说明往往是最先被投诉的那份文件。原因通常不是写得少,而是写得像给自己人看的:默认读者知道现场电压、知道型号差异、知道"拧紧"是多大扭矩。海外工程师第一次接触你的设备,任何一处默认都会变成一次邮件往返。
步骤型内容的目标很明确:读者照着做完,并且做的过程中知道自己在哪一步。下面这些做法针对的就是这个目标,和标记无关。
开头先写前提,不写背景
步骤之前需要一段前提清单,列的是"不满足就不能开始"的条件:电源制式与容量、气源压力、基础地面承载、环境温度、需要的工具与耗材、必须由持证人员完成的部分。这一段常被写成产品介绍,实际上它唯一的职责是让读者在开始之前判断能不能动手。
前提清单还有一个作用:现场条件不满足时,读者有理由停下来联系供应商,而不是硬装。对你来说,这能减少现场返工。
一步只做一件事
把"拆下护罩并检查叶轮后重新安装"写成一个步骤,读者会在两个动作之间犹豫:检查发现异常怎么办、要不要装回去再检查。拆开写会占几行,但每一步都只有一个动作、一个对象,读者不容易跳步。动词开头的短句在实际使用中表现最好,因为现场工程师是边看边做,不是阅读文章。
编号必须连续且有层级。用"1.1、1.2、2.1"这种结构,读者跑到一半被打断,回来还能找到位置;用"首先、然后、接下来"的叙述体,一旦被电话打断就需要重读整段。
每一步都要有一个能判断的结束条件
"拧紧螺栓"不是可执行的步骤,"按规定扭矩拧紧"好一点,"以 45 N·m 拧紧,听到扭矩扳手咔响后停止"才是可执行的。判断标准可以是数值、可以是一个可见状态、也可以是一个可测量的结果。以下是教学样例(数值为演示用,不是任何客户手册里的实际要求):
步骤 3|连接液压软管
动作:将 A 口软管接头旋入泵体,手拧到底后使用扳手再旋 1/4 圈。
判据:接头处无可见间隙,沿管身轻拉不松动。
记录:在安装记录表上填写接头批号。
失败处理:若旋入过程中出现卡滞,停止并检查螺纹,不要继续加力。
这一段里"再旋 1/4 圈"是动作标准,"无可见间隙、轻拉不松动"是判据,"填写批号"是留痕,"出现卡滞则停止"是分支。四样齐全,现场就不需要打电话问。
失败路径要写,但不要写成一整套应急预案
官方文档里常见"如果……请联系技术支持",这句话在现场几乎没用,因为工程师需要知道的是"在联系之前先做什么"。可行的方法是在每个关键步骤后面加一行失败处理,只写两件事:什么情况下停手、停下来之后检查什么。真正的应急预案放在单独一节,避免把主流程撑得读不下去。
另外,安全相关的动作(断电、泄压、挂牌)必须写成独立步骤并放在动作之前,不要写成括号里的提醒。括号会被跳过。
如果给步骤配图,图要能回答"这个动作落在哪个位置",所以接口、标识、刻度这些细节比整机外观更有用;一张干净的产品照放在安装章节里,几乎不会减少任何一次提问。拍不到现场时,标注过的插画或示意图同样可以,只要明确写清是示意。
型号、版本和多语言版本要分别交代
一个系列的设备通常有多个配置,步骤会分叉。把所有分支塞进一条主线,读者会在错误的地方执行正确的动作。可行做法是:主线写通用步骤,分叉处明确写"仅 X 型号:见 3.4",并给分叉段落一个可单独访问的标题或页面。这样现场工程师可以直接把链接发给同事。
多语言版本还有一个容易忽略的细节:单位、工具名称和编号体系。德语现场的扭矩单位习惯用 N·m,北美现场可能用 ft·lb;工具名称直译后可能对不上货架上的实物。稳妥的做法是首次出现时给出"本地叫法 + 编号 + 图片",此后统一使用编号。
关于标记:HowTo 富媒体结果已经不展示
如果你还在按旧教程给安装步骤加 HowTo 结构,值得先核对一件事:Google 已经移除了 How-to 结构化数据的文档,Google Search Central 文档更新记录的说法是"The How-to structured data documentation"被移除,"as this rich result is no longer shown in search results, on both desktop and mobile devices"。也就是说,加这套标记不会带来对应展示。
这反而让事情变简单:步骤内容只需要对读者负责。官方在生成式 AI 优化指南里对内容组织的建议也是对人的——"People generally appreciate it when web pages are organized by paragraphs and sections, along with headings that provide a clear structure to navigate content."
光算在GEO 服务里处理这类资料的顺序是:先把可执行的步骤补全,再看哪些外部渠道需要用到同一份步骤说明,最后用问题集复测"平台在回答相关问题时是否准确描述了适用条件"。标记从来不是这一步的重点。
如果这些步骤是给客户或服务商做验收用的,下一步可以把它整理成可勾选的检查表;如果步骤里出现了具体参数,最好同时按同单位同条件的表格整理一份,避免同一台设备在两份文件里写出两套数字。
同一套工作里,下面几篇会接着用到:技术SEO审计一堆红项,先修哪一个?用影响范围和证据排序。