写作技巧:新合同

解释复杂材料的重要概念

好的写作往往与语法和惯例无关,而与读者是谁以及他们所知道的无关。 当您在解释某些内容时,例如在技术写作,报告或文档编制中,这尤其正确。 当我们解释时,我们必须想象听众知道什么,什么将是完全陌生的,以及我们如何建立概念性的桥梁以护送读者从他们所处的位置到我们希望他们在完成时所处的位置。 (这也有助于想象它们可能对您的主题具有的任何先入为主的观念和倾向,但这是另一回事了。)

要做到这一点,需要做很多工作,但是在这篇文章中,我想集中讨论这种桥接的一个核心方面:将新思想整合到现有思想中。

假设我想向您介绍一款名为“ stumblesphere”的新游戏。 您会说:“我从未听说过这款游戏。”然后我说,“这就像棒球一样,只不过我们在比赛前几天让一堆黑痣在野外散开了。”

我的解释假设您知道什么是棒球和什么痣。 如果我是对的,那么使用这些现有的概念围绕名为stumblesphere的游戏来构建一个新的概念并不难,您可能不想玩,但确实想观看。

在书面形式上,没有人提示您解释一个新想法。 您必须猜测是否需要解释。 但是,同样的原则适用。 我们将陌生人与熟悉的人融为一体。 如果您曾经参加过入门写作课,那么您可能已经听说过这种称为新合同的合同。

新合同

新的已知合同是一种构造句子的方式,您可以从熟悉的信息开始,以新信息结束。 (例如,这是在玛莎·考恩(Martha Kolln)的写作指南“ Rhetorical Grammar”中的介绍 。)您可以使用此技术来构建句子链,其中一个句子的新信息成为下一句的旧信息。 例如,以下是EPA解释酸雨的方式:

什么是酸雨?

当二氧化硫(SO2)和氮氧化物(NOX)排放到大气中并通过风和气流进行运输时,就会产生酸雨。 SO2和NOX与水,氧气和其他化学物质反应形成硫酸和硝酸。 然后将它们与水和其他材料混合,然后掉到地面上。

标题设定了期望:我们将谈论酸雨。 然后,第一句话以相同的想法“酸雨”开头,并引入了一些新信息-它是由大气中的某些化学物质引起的。 第二句话以化学物质开始,并引入化学反应。 这是工作中的新合同。

这段内容还包含一些新的违规行为-引入了多个新信息的句子。 在第一句话中,我们了解到化学物质的排放和化学物质随风而来。 在第二句话中,我们了解到化学物质会与水发生反应,并且它们会形成新的化学物质。 对我来说,这段话还是很让人困惑。 一次有太多新信息。

新签订的合同是检查和修改句子以使其清晰的一种有用方法。 但是,我发现有一个局限性,那就是它在句子结构方面构筑了含义:熟悉的东西应该在句子的开头,新的东西应该在句子的结尾。 如果您真的坚持这一点,那么您的写作将变得僵硬而充满挑战。 这些句子的节奏都差不多,而您的步调总是差不多。

就个人而言,我发现更容易减少对句子结构的关注,而更加关注听众已经知道和不知道的内容。 这可以帮助我了解何时需要使用示例,或者在我觉得很熟悉之前用多个句子解释一个新概念。 结果是新合同的一种灵活一些的版本,我称之为“新到已知”。

新的至未知的合同

解释需要一系列思想结构。 我认为这种新的契约构成了水平逻辑结构。 每个新句子都会引入一个新的想法,在文本中移动会带您跨越多个想法。

但是有时您需要更深入地探索单个想法。 在这种情况下,以未知的方式进行思考可能会更有帮助。 (说句公道话,您可能已经通过数百次的口头和书面解释来了解这一点。在这里我们只是将其明确。)例如,示例。

以下段落摘自Atom文档,Atom是用于编写代码的程序:

您可以通过将目录的路径传递到atom命令行工具来从命令行打开任意数量的目录。 例如,您可以运行命令atom ./hopes ./dreams来同时打开hopes和dreams目录。

第一句话向我们介绍了可以在Atom中运行以打开多个文件目录的命令。 但是,“命令”仍然有些抽象。 为了进一步阐明它们的含义,作者举了一个例子。 有时,“新”概念是抽象的或复杂的,因此需要多句话来解释。 知道您可以键入“命令”并没有多大用处,因为系统通常会有许多执行不同功能的命令。 我们需要知道哪些命令可以做什么。

这是一个描述建筑职业的网站的一段话:

瓦工根据图纸和规格铺设砖,混凝土砌块,石材和其他类似材料,以建造或维修墙壁,拱门,烟囱,壁炉和其他结构。 您可能在商业和工业熔炉和焚化炉中安装耐火砖。 您也可以在制浆厂中使用酸砖和酸砖。

所有这三个句子通过一个想法起作用:瓦工在日常工作中做什么? 如果您认为您的听众真的想理解,那么花很多时间在某件事上是很有意义的。并且由于此站点被称为“建设中的职业”,我们可以猜测,在这里,他们正期待着潜在的瓦工。 重要的是要对关键概念尽可能多的理解。 对于这位作者而言,瓦工直到我们对专业人员从事的活动和环境的多样性有所了解后,才成为“知名”概念。

最后的话

我不认识任何作家在撰写本书时都会想到这些东西。 如果您担心草案1中句子的确切结构,您可能会很难取得进展。但是,当您的直觉表明一个概念不清楚时,新已知或新到未知将变得很有用。 您可以使用它们来解开一两个段落,以了解概念需要更深入的解释,以及期望读者已经比他们拥有更多的背景知识的地方。