VKQUANT 写作研习图册
写作图册 / 组织成文 / 第 15 章
全书目录

PART 04 · CHAPTER 15

把一件事解释清楚

自己觉得很简单的事,为什么别人照着文字还是做不对?

你熟悉一件事,反而容易省略最关键的步骤。读者可能不知道一个词是什么意思、按钮在哪里,也不知道出现例外时该怎么办。解释清楚不是把知道的东西全部倒出来,而是帮特定读者走过真正的理解缺口。本章用一个小规则练习说明、举例和划定边界。

主题插图:组织成文
第 4 部 · 组织成文 / 原创概念静物

先知道对方卡在哪里

布朗提醒,说明书看起来简单,读者却经常因为作者漏了一步而做不下去。准备解释前,先想读者已经知道什么、接下来需要做什么。你要说明的是一个词、一条规则,还是一套操作?如果没有分清,可能花很长篇幅介绍背景,却没有回答读者眼前的那个问题。

例如,首次报名的人问“候补是什么意思”,他未必需要了解活动的全部管理制度。先告诉他:名额满时可以登记等候,有人退出后才可能获得名额。再说明如何接收通知、多久内回应。读者知道了这条规则,才有条件决定要不要登记,而不会误把候补当成已经报名成功。

先直说,再决定要不要打比方

吴军谈修辞时强调,用读者熟悉的事物解释陌生事物,相似点还要直观。比喻不是展示知识的装饰。解释候补时,可以说“有点像排队等空出的座位”,让读者抓住等待顺序;但若读者不熟悉你借用的事物,原本的一道理解题就会变成两道。

比喻只传达某个相似处,不能把其它规则一并带过来。排队等座可能让人以为只要一直等就必定有位置,活动候补却未必如此。因此要补一句:没有人退出,就不会新增名额。若一句直接说明已经足够清楚,不使用比喻也完全可以。解释是否有效,取决于读者是否理解,而不是修辞数量。

例子要照亮规则,也要照见例外

给出一个小例子,能让抽象规则变得可检查。比如在练习设定中,候补按登记先后联系;第一位收到通知后在规定时间内未确认,才联系下一位。读者可以据此辨认什么情况下轮到自己。例子应与实际规则一致,不能为了让故事轻快,就把确认期限、通知方式等关键条件省掉。

布朗给看管人的说明范例,补进了夜灯位置、睡前读物和联系电话。这些细节不一定适用于你的任务,但它们说明一件事:具体到能帮助对方判断和行动,细节才有用。说明很短却让读者不断猜测,未必比略长而完整的说明更高效;不影响理解的枝节则可以放到附录或另一个页面。

让不熟悉的人试着复述或执行

写完后,请一个接近目标读者、又不了解背景的人说说自己理解的规则。如果是操作说明,也可以请他按文字走一遍。不要一见他停住就马上口头补充;先记下停在哪里、把哪句话理解成了什么。口头一解释就会,说明作者知道答案,并不说明原来的文字已经写出来了。

根据这种反馈修改时,要分清缺的是定义、顺序、例子还是限制。把一个难词换成另一个难词,通常不会解决问题。也不必见到一次误读就重写所有内容;先改最容易造成错误判断的地方,再请对方确认。目标不是让读者背出原句,而是让他能用自己的话说明,并知道什么时候不能照搬。

图册练习情境|说明候补规则

原先的写法 / 做法

报名名额已满,欢迎加入候补,届时按规则处理,请留意通知。

改写 / 调整后

名额已满后,您仍可登记候补。若有人退出,我们按登记先后发短信联系;收到通知后请在一天内确认。登记不等于已有席位;没有收到确认通知,请先不要按正式参与者安排行程。

通知方式、先后顺序和一天期限都是练习设定,不是所有活动的共同规则。改写补出了候补的含义、触发条件与回应动作。正式使用前还要核对主办方能否做到这些安排,不能把示例当成实际承诺。

理解缺口与熟悉的入口

布朗从读者所需信息和说明的完整性出发,吴军提醒比喻必须依靠读者熟悉的概念。我们的整合是先直接说明规则,再选择能降低理解难度的比喻,并明确它没有覆盖的条件。语言生动与规则准确可以共同追求,但不能用生动代替准确。

还要分清两种理解目标:读者能解释候补是什么,不代表他已经知道如何登记;会点击登记,也不代表他明白没有保证席位。前者需要概念和边界,后者还需要操作信息。测试时分别提问,比只问一句“看懂了吗”更容易发现漏掉哪一部分。

试写 · 比较

试着比较|怎样解释候补

目标读者第一次参加活动,不熟悉“候补”;本练习的候补确实按登记先后联系,但不保证人人获得名额。

选择一种写法或做法,查看它适合什么条件。可以反复比较。

停一下 · 检查理解

读者把“像排队等空座”理解成“等得够久必定有名额”。怎样改更合适?

把方法用一次

选一段你熟悉的规则,划出读者可能不知道的词,再请一人只凭文字复述下一步。

带到写作工作台 →

读完后由你决定是否标记。

本章来源与页码

页码为指定PDF的物理页,从1开始。练习情境与改写由图册编写,不冒充原书案例。

  1. 布朗·完全写作,PDF第 21、22、31、32、51、191、192、193 页。范围概述|了解你的读者;修改与寻求帮助;网络写作;写给看管人的注意事项;对应:补足默认知识、简洁与完整平衡,以读者反馈修订说明。
  2. 吴军·阅读与写作,PDF第 112、113、114、117 页。范围概述|2.3 修辞:如何让外行理解陌生的东西;对应:由熟悉解释陌生;相似点需直观,比喻也会因读者背景而失效。
全书来源与整合范围 →