Illustrating
还记得老师给你布置的大阅读作业吗？你翻阅教科书中的对应章节，拼命地查找...图片！看插图比阅读文字有趣得多。事实上，绝大多数成年人在阅读技术材料方面仍是小孩子 -- 仍然渴望图片而不是文字。
Nirmal Dulal [CC BY-SA 4.0 (https://creativecommons.org/licenses/by-sa/4.0)]
根据Sung 和 Mayer (2012)的研究报告，在文档中插图 -无论质量好坏- 会增加读者对文档的好感。然而，只有指导性的图片才会帮助读者学习。一图胜千言，本单元建议了一些为文档配图的技巧。
先确定插图标题
在对文档进行插图前，先确定插图标题总是有用的。之后，再创建最适配标题的插图。这个过程可以确保插图有达到其目的。
好的插图标题有以下特征：
- 简洁。一般来说，插图标题仅包含几个单词。
- 解释要点。看完这个图后，读者需要记住什么？
- 聚焦读者注意力。当图片或者图标信息很多时，聚焦尤其重要。
练习
假设你的目标读者是计算机科学专业本科生，正在上“数据结构简介”课程。如下三张图片是课程配图，使用同样的标题。哪张图片是标题的最佳适配？
- Figure A是错的。虽然图片很漂亮，但是没有提供任何信息。这个链表还错误地将单向链表编程双向。
- Figure B还好。虽然该插图帮助学生了解第一个节点链接到第二个节点，第二个节点链接到第三个节点，以此类推。但是图示上仅体现了链表指针，并没有呈现标题中提及的节点内容。
- Figure C是标题的最佳适配。图示清晰地呈现了链表节点内容和链表指针。
限制单个图片上的信息量
一副精美画作可以逐层揭示更深层次的意义，人们在世界各地艺术博物馆花很多钱来研究这些大作。
相反，像下图一样过于复杂的技术文档插图，会让读者望而却步。
就像你应该避免使用过长的句子一样，请避免视觉上的重复。根据经验，不要将一个段落的信息量放到单张图片内。具体地讲，应该避免使用需要五个列表项才能讲清楚的图片。
将复杂的系统组织成子系统，可以帮你将视觉上的混乱精简得更有条理。如下图所示：
呈现系统整体的图示后，插图介绍每一个子系统的细节。例如：
聚焦读者的注意力
当在屏幕上看到下图一样的图片时，读者很难确定图片要说明什么。
如果加上像下图红色椭圆一样的视觉提示，读者则很容易聚焦到图片真正要呈现的内容。
另外一种聚焦读者注意力的方式是在图片上做标注。图片或者线条上的标注，可以帮我们的眼睛找到正确的“着陆点”。标注往往比大段对图片的文字说明更好。这是因为的标注将读者的注意力聚焦到图片最重要的信息，这样你就可以直接解释你的重点，而不用花时间描述你在讲的是图片的哪个地方。
例如，下图中的箭头和标注让读者可以快速的聚焦到重点。
插图阐述即是重新阐述
极少数第一版文档草稿的插图是足够好的。修改你的插图，让其内容更清晰。在修改时，问自己以下问题：
- 我该怎么用简化插图？
- 该将插图拆分为两个或更多更易理解的图吗？
- 图中的文字是否清晰？和背景的对比度是否足够？
- 图中的重点是什么？
例如，下图是伦敦地铁交通图。1931 年之前，地铁图是等比例绘制的，即完全按照地上道路和地铁轨道弯曲度一样弯曲。
1931年，Harry Beck主导了一种新的公共交通图，通过移除地面标记和比例尺，从而简化了旧地图。他的设计中，将信息专注在地图使用者真正关心的部分，即怎么从A站到B站。即使1931年的地址大获成功，Beck在随后的多年中仍然不断简化地图从而使其更清晰。现代的伦敦地铁交通图，尽管增加了新的线路和站点，但仍然使用Beck早期的设计。
练习
参考如下插图：
图中想要表达重点应该是：
函数的递归是指，函数在返回处调用自身，直到到达停止点。
上图中是怎样用复杂的呈现让人看不到重点的？如何解决这个问题？
上图的一些问题包括：
- 问题：图中的高亮将读者的注意力吸引走，而让人忽略真正的重点。解决：慎重选择颜色，避免掩盖重点。
- 问题：图片的色彩对比度不够，对低视力或者特定色盲无法阅读。解决：移除不必要的颜色，确保颜色复合标准色彩对比度建议。
- 问题：图片上的双向箭头，让人迷惑于图片上流程真正的走向。解决：将双向箭头拆开，一个方向描述函数调用，一个方向描述函数返回
改进后的上图如下：
上图还有哪些可以修改的地方？
上图的仍有如下两个问题：
- 图片仍然过于复杂，需要花费超过一个段落来解释这个插图。可以考虑移除一些多余的信息，或者增加一些更明显的标签来简化。
- 尽管已经将函数调用和函数返回分为不同的箭头，仍可以考虑加上一些标签说明，让读者知道返回值是啥。
画图工具
画图工具有很多，如下三个画图工具是免费的或者部分免费的：
当从工具导出图片到文档使用的时候，通常的最佳选择是SVG( Scalable Vector Graphics)格式。该格式可以在不影响图片高质量的情况下，被放大或缩小以适配文档大小。
Reference
原文：https://developers.google.com/tech-writing/two/illustrations