如果操作说明只写“仔细检查连接是否正确”,读者可能每个字都认识,却仍不知道下一步该看哪里。接口名称没有写,合格状态没有写,检查后出现异常怎么办也没有写。把“仔细”翻译得再自然,这些空缺仍然存在。

Google开发者写作指南10月16日的变更记录,补充了避免主观语言的通用建议,包括simply、quickly、properly、carefully等词。它面向技术文档,不是产品安全标准;对中国制造企业的英文说明书而言,可借用的原则很具体:不要用一个评价读者动作的词,代替完成动作所需的信息。

让读者知道看什么、何时看

一条检查指令至少要有对象。写“检查连接”,可能指线缆两端、软件中的设备状态,也可能指某个接头是否完全插入。作者熟悉产品时容易省掉这些区别,海外分销商或首次操作的人却没有相同背景。把部件的实际名称写出来,比连续增加“认真、正确、充分”更有用。

接着看前置条件。某项检查是在安装前、接通电源前,还是完成指定设置后进行,不能由翻译人员根据常识补全。不同产品的正确顺序不同;涉及电气、压力、温度等条件时,应由负责产品技术与安全的人确认,文案编辑不能为了让句子完整而自行编一个操作步骤。

最后是可观察的结果。界面显示什么状态、哪个标识应当对应哪个端口,只有原始技术资料能够支持时才写入。若内部还没有定义合格状态,就把缺口退回技术负责人。删除“正确”并不自动使句子准确,必须有足以替代它的依据。

这些内容不必挤进一句长话。前提放在动作之前,动作之后说明预期状态;出现异常时,指向明确的停止条件或已有排查章节。读者不应先做完,再在后面的括号里发现自己原本不满足前提。

英文稿要检查含义,不只检查语法

跨境团队可以先挑几条最常被问到的操作说明,给每条标出对象、条件、动作和结果。空白处先找原始资料,不急着让AI扩写。这样能区分两类工作:原文已经有信息,只是表达含混;或者产品团队本来就没有说明这项条件。后一类不是翻译润色能解决的。

还要保持部件名称一致。正文叫control unit、图里叫controller、售后邮件又换成别的名称,可能让人误以为是不同部件。是否需要保留型号、界面原文或增加解释,应按读者查找对象的需要决定,而不是为了英文多样性不断换词。

产品演示被转发后仍要保留限制条件,讨论的是资料离开原讲解者以后还能不能独立成立。操作说明面对同样的现实:买家未必有人在旁解释。这里进一步要落实到每一步能否照着做、能否判断是否完成。

技术审阅也不应只问“翻译有没有错”。可以让未参与写作、但具备相应操作资格的审阅者指出每条指令的对象与完成状态;只做文档走查,不冒险尝试未经批准的现场操作。若必须靠作者口头补充才能理解,应把必要信息补回对应位置。

一份好的操作说明不需要不断告诉读者“这很简单”。它需要让读者知道自己是否具备条件、正在操作哪个对象,以及什么结果意味着可以继续。

参考来源