您的文档对读者友好吗？

图片来源：

原始照片由 mpclemens 拍摄。由 Rikki Endsley 修改。CC BY-SA 2.0

任何一位有成就的技术作家的首要任务都是为读者写作。这个任务听起来很简单，但是当我想到世界各地的人们时，我开始思考：他们能读懂我们的文档吗？可读性是一个已经被研究多年的课题，以下是对研究结果的简要总结。

研究证明，人们会对他们容易理解的信息做出反应。问题是：我们编写的内容是否是普通人可以轻松阅读和理解的？如果人们无法理解我们的内容，原因之一可能是我们写得“太高深”，这种情况比您想象的更常见。为了听起来更优秀、更聪明或更像我们领域的专家，许多人会过度写作内容，或使用大词来占据最多的印刷材料空间。

检查您的文档是否易于阅读的一个简单方法是使用可读性测试。为此目的已经创建了许多不同的测试，其中最流行的三个是

流行的可读性测试

弗莱士阅读容易度测试

鲁道夫·弗莱士，约翰尼为什么不会阅读：《以及您能为此做些什么》的作者，创建了弗莱士阅读容易度测试，以进一步推进他认为美国教师需要回归语音教学而不是视觉阅读（整体单词识字）的信念。他的工作和对阅读和语音学的倡导是苏斯博士创作戴帽子的猫的灵感来源。此测试告诉我们文本的易读程度。算法如下

algorithm

^{图片来自维基百科。 CC BY-SA 3.0}

结果得分解释如下

table

^{表格来自维基百科。 CC BY-SA 3.0}

这意味着什么？

分数越低，文本越难阅读
65 分是“简明英语”评级

这个分数与知名出版物相比如何？[1]

读者文摘：65
时代杂志：52
哈佛法律评论：>40

弗莱士-金凯德学年级别可读性测试

弗莱士-金凯德阅读测试是鲁道夫·弗莱士（上面提到过）和 J. 彼得·金凯德之间合作的成果。J. 彼得·金凯德是一位教育家和科学家，他一生都在学术界工作或在美国海军进行研究。J. 彼得·金凯德在与海军签订合同期间开发了他的可读性测试版本，目的是评估技术手册的难度。弗莱士-金凯德学年级别可读性测试将测试转换为美国学年级别，这使得判断材料是否易于他人阅读变得更容易。算法如下

algorithm

^{图片来自维基百科。 CC BY-SA 3.0}

结果对应于美国学年级别，因此一旦计算出分数，我们就知道谁可以理解我们的写作。例如，奥巴马总统的2012 年国情咨文的学年级别为 8.5；然而，平价医疗法案的可读性级别为 13.4（大学或更高学历）。一些流行书籍的可读性结果可能会让您感到惊讶：

晚安，月亮（玛格丽特·怀兹·布朗的儿童读物）：2.8
老人与海（美国作家欧内斯特·海明威著）：4.1
哈利·波特与死亡圣器（J.K. 罗琳的哈利·波特系列的最后一本小说）：7.8
从优秀到卓越：为什么有些公司能够实现飞跃...而另一些公司却不能（詹姆斯·C·柯林斯的管理书籍）：10.4

冈宁雾度指数

冈宁雾度指数创建于 1952 年。算法如下

algorithm

^{图片来自维基百科。 CC BY-SA 3.0}

这个指数并不完美，因为有些单词（例如university）很复杂但容易理解，而短词（例如boon）可能不容易理解。鉴于此，结果可以解释如下 [2]：

雾度分数 >12 最适合美国高中毕业生
8-12 之间（更接近 8）是理想的
<8 接近普遍理解

为什么我应该关心我的写作的可读性？

如果我们的写作太难阅读，那么没有人会想阅读它。可悲的事实是，大约 50% 的美国人具有八年级的阅读水平。我们的写作学年级别越高，可以阅读它的人就越少。如果我们很难阅读某些内容，那么我们对内容的体验将是负面的，而这种负面体验会使我们不太可能向其他人推荐该内容。您有没有推荐过您不喜欢读的书？文档也是如此。