先把两种说法都保留下来,再为它们建立一条可核对的对应关系:专家术语负责精确,客户口语负责可理解。具体做法是,把客户口语当作待验证的问题描述,把专家术语当作回答该问题的定义,然后用一个双方都能检查的事实把两者连接起来。这样写出的段落不会变成两套语言的拼贴,而是同一件事的两种说法。
同一件事出现两种说法,原因通常不是谁错了,而是分歧落在不同层面。先分三类:
分类之后,文章里该保留哪种说法就清楚了:如果分歧是对象不同,两种说法都要写,因为一个说现象、一个说机制;如果只是粒度不同,客户口语可以放在开头,专家术语放在解释段,不必并列成两个小标题。
客户口语往往包含情绪和模糊指代,直接写进文章会显得不专业,直接删掉又会让读者觉得答非所问。可行的处理是把它拆成三样东西:触发条件、观察到的现象、期望结果。
假设一位读者反馈“你们的说明根本看不懂”。这句话不能直接当标题,但可以拆成:他在什么情况下读(触发条件),读到哪里卡住(现象),希望读完能做什么(期望结果)。拆完之后,专家术语才有落点——“看不懂”可能对应术语未定义、步骤缺前置条件、示例与他的场景不匹配。每一种都对应不同的修改动作,而不是笼统地“写得更通俗”。
这一步的动作会直接影响下一步:如果拆出来的是术语未定义,就在首次出现时补一句白话解释;如果是前置条件缺失,就补一段适用前提。两种修改落在不同位置,不能互相替代。
衔接的关键不是把术语翻译成口语,而是找到一条双方都承认的事实。这条事实最好是可以观察或复述的,而不是评价性的。
例如客户说“这个功能没用”,专家说“该功能在当前配置下未生效”。共同事实是“在某个具体操作下没有出现预期变化”。围绕这条事实,文章可以先写客户看到的结果,再写专家判断的原因,最后写需要核对哪一项配置。读者既能对上自己的体验,也能拿到可执行的检查项。
如果找不到共同事实,说明分歧还没收敛,此时不宜急着下结论。可以先在文中列出双方各自依据,标明还需要补充什么信息,把未决状态如实写出来,比强行统一口径更可信。
同一篇文章里,两种语言不必平均分布。常见的安排是:
这样安排的原因是:读者先被场景接住,才愿意接受术语;术语出现后立刻被落到动作上,才不会变成装饰。若把术语全部堆在前面,客户口语只在结尾出现一句,读者会在开头就流失。
并非所有情况都需要双语并存。如果读者群体本身就是同行,客户口语可能只是噪声,保留它会稀释精确度;如果页面面向首次接触该问题的普通读者,专家术语在首次出现时若不解释,就会变成门槛。
判断依据是:读者是否需要靠这个词去做下一步。需要,就保留并解释;不需要,就换成更直接的说法。两种说法并存的代价是篇幅变长、节奏变慢,只有在分歧真实存在、且双方都要在同一页面上得到回应时才值得。
最后要提醒的是,衔接不是一次性完成的。发布后如果仍收到“看不懂”或“不准确”的反馈,应回到分类那一步重新判断分歧属于对象、粒度还是标准,而不是简单地在术语后面加一句同义词。同义词换写不会带来新的信息,只有补上可核对的事实,两种说法才会真正接上。