任何有成就的技术作家的首要任务都是为受众写作。这个任务听起来很简单,但是当我想到世界各地的人们时,我就想:他们能读懂我们的文档吗?可读性是一个被研究多年的课题,接下来是对研究成果的简要总结。
研究证明,人们会对他们容易理解的信息做出反应。问题是:我们编写的内容是否是普通人可以轻松阅读和理解的?如果人们没有与我们的内容产生共鸣,原因之一可能是我们写的“过于高深”,这种情况比您想象的更常见。为了听起来更优越、更聪明或更像我们领域的专家,许多人会过度写作内容,或者使用大词来占据最多的印刷材料空间。
检查您的文档是否易于阅读的一个简单方法是使用可读性测试。为此目的已经创建了许多不同的测试,其中最流行的三个是
流行的可读性测试
弗莱士易读性测试
鲁道夫·弗莱士,为什么约翰尼不会读书:以及你能为此做些什么的作者,创建了弗莱士易读性测试,以进一步推进他的信念,即美国教师需要回归教授语音而不是视觉阅读(整体单词识字)。他的工作和对阅读和语音的倡导是苏斯博士创作戴帽子的猫的灵感来源。此测试告诉我们文本的可读性有多高。算法如下:
图片来自 维基百科。CC BY-SA 3.0
结果分数解释如下:
表格来自 维基百科。 CC BY-SA 3.0
这意味着什么?
- 分数越低,文本越难读
- 65 分是“简明英语”评级
这个分数与著名的出版物相比如何? [1]
- 读者文摘:65
- 时代杂志:52
- 哈佛法律评论:>40
弗莱士-金凯德学年级别可读性测试
弗莱士-金凯德阅读测试是鲁道夫·弗莱士(上面提到过)和 J. 彼得·金凯德 合作的结果。J. 彼得·金凯德是一位教育家和科学家,他一生都在学术界工作或在美国海军进行研究。J. 彼得·金凯德在海军合同下开发了他的可读性测试版本,旨在估计技术手册的难度。弗莱士-金凯德学年级别可读性测试将测试转换为美国学年级别,从而更容易判断其他人是否可以阅读该材料。算法如下:
图片来自 维基百科。 CC BY-SA 3.0
结果对应于美国学年级别,因此一旦计算出分数,我们就知道谁可以理解我们的写作。例如,奥巴马总统的2012 年国情咨文的学年级别为 8.5;然而,平价医疗法案 的可读性级别为 13.4(大学或更高)。一些流行书籍的可读性结果可能会让您感到惊讶:
- 晚安,月亮(玛格丽特·怀兹·布朗的儿童读物):2.8
- 老人与海(美国作家欧内斯特·海明威):4.1
- 哈利·波特与死亡圣器(J.K. 罗琳的哈利·波特系列的最后一本小说):7.8
- 从优秀到卓越:为什么有些公司能够实现飞跃,而另一些公司不能(詹姆斯·C·柯林斯的管理书籍):10.4
冈宁雾指数
冈宁雾指数创建于 1952 年。算法如下:
图片来自 维基百科。 CC BY-SA 3.0
此指数并非完美,因为有些单词(例如university)很复杂但易于理解,而短词(例如boon)可能不太容易理解。鉴于此,结果可以解释如下 [2]:
- 雾指数 >12 最适合美国高中毕业生
- 8-12 之间(更接近 8)是理想的
- <8 接近普遍理解水平
为什么我应该关心我的写作的可读性?
如果我们的写作太难读,那么就不会有人想读它。可悲的事实是,大约 50% 的美国人的阅读水平在八年级水平。我们的写作学年级别越高,可以阅读的人就越少。如果我们难以阅读某些内容,我们对内容的体验将是负面的,这种负面体验使我们不太可能向其他人推荐该内容。您是否曾经推荐过一本您不喜欢阅读的书?文档也是如此。
我如何计算我的写作的可读性?
有几种方法可以计算可读性。最简单的计算方法是在文字处理器或编辑工具中进行。例如,Publican 是一款基于 DocBook XML 的发布工具。Publican 4.0.0 版本包含了 Flesh-Kincaid 统计信息 功能的添加,该功能允许用户运行以下命令
$ publican report --quiet
这将生成一份可读性报告。
如果您使用 vim 作为您的文本编辑器,可以从 GitHub 下载并安装 vim-readability 插件(感谢 Peter Ondrejka)。gedit 也提供了一个类似的插件 gulpease。要检查可读性而无需使用插件,请复制文本并粘贴到 Readability-Score.com。
最后的想法
保持简单,亲爱的!我们的文档越容易理解,使用的人就越多。如果您好奇,本文的可读性为:
- 弗莱士:68.5
- 弗莱士-金凯德:6.9
- 冈宁雾指数:9.3
一旦我们知道我们写作的可读性,我们就可以在必要时简化它。我将在我的下一篇文章中概述简化它的想法。敬请期待!
来源
- 弗莱士-金凯德可读性测试(维基百科)
- 冈宁雾指数
- 这篇令人惊讶的阅读水平分析将改变你的写作方式,作者:Shane Snow
- Readability-Score.com
8 条评论