一次在 少数派 上浏览「一日一技」，评论区有句话挺有意思，大意是：
「根本不用长篇大论这么麻烦，一个什么什么操作就能搞定。」
下面有个经常看到的作者回复他：
「那不如你写一篇教程？」
于是这个人就说：
「用得着写一篇教程？就是这个操作。（紧接着用一句话描述了具体操作，而且确实能够解决问题）」
那个作者又说：
「你这样写，别人是没有兴趣去读的…」
这段评论离现在也有不短的时间了，因此我没能找到原文地址。不过，如果你读过「一日一技」，想必你也会同意有几篇的内容确实有点「水」。特别是某些行文较长的作者，往往会把一个简单的操作洋洋洒洒写个一两千字。对于纯小白来说，这样的文章可能还显得比较友好；但对于熟悉大致操作的暴躁老哥，就可能会引发上文中的对话了。
由此，我想探讨一下：在互联网上介绍某种操作、撰写教程时，究竟是该「一针见血」，用高度凝练的三两句话阐明；还是该「娓娓道来」，让完全不了解情况的小白也能读懂？
「一针见血」 有什么好处？
- 信息密度更高，提高阅读效率。有句话叫「浓缩的才是精华」，在有限的阅读时间内，经过高度凝练的表述显然更有价值、更具效率。
- 避免 TL; DR (Too long; didn’t read)。有不少人（包括我）看到长文，往往就会失去阅读兴趣。文章写得越长，劝退效果也越强。
「娓娓道来」有什么好处？
- 对读者更友好。尽管可能会有上文中提到的 TL; DR 现象，但对于剩下的读者而言，较长的文章往往在介绍上更为全面、细致，读起来更舒服。
- 知其然，知其所以然。「娓娓道来」式的长文往往还包含作者发现问题、思考如何解决问题的过程，而非简单地给出问题的答案。这无疑有利于读者举一反三，收获更丰。
所以说… 究竟谁更好？
显然，「一针见血」还是「娓娓道来」谁更好，并没有一个定数。我认为，如果某个操作比较简单、无需太多思考过程，「一针见血」往往更好；而如果需要体现解决某个问题的思考过程，「娓娓道来」更合适一些。
但我觉得，无论如何都应该遵循一点：永远不要把教程写得比产品说明书还长！
（此处的产品说明书，主要针对电子设备的支持网页，如 Apple Support 上的说明内容。某些过短的迫真说明书，不在讨论范围。）