一次在 少数派 上浏览「一日一技」,评论区有句话挺有意思,大意是:
「根本不用长篇大论这么麻烦,一个什么什么操作就能搞定。」

下面有个经常看到的作者回复他:
「那不如你写一篇教程?」

于是这个人就说:
「用得着写一篇教程?就是这个操作。(紧接着用一句话描述了具体操作,而且确实能够解决问题)」

那个作者又说:
「你这样写,别人是没有兴趣去读的…」

这段评论离现在也有不短的时间了,因此我没能找到原文地址。不过,如果你读过「一日一技」,想必你也会同意有几篇的内容确实有点「水」。特别是某些行文较长的作者,往往会把一个简单的操作洋洋洒洒写个一两千字。对于纯小白来说,这样的文章可能还显得比较友好;但对于熟悉大致操作的暴躁老哥,就可能会引发上文中的对话了。

由此,我想探讨一下:在互联网上介绍某种操作、撰写教程时,究竟是该「一针见血」,用高度凝练的三两句话阐明;还是该」娓娓道来「,让完全不了解情况的小白也能读懂?

「一针见血」 有什么好处?

「娓娓道来」有什么好处?

所以说… 究竟谁更好?

显然,「一针见血」还是「娓娓道来」谁更好,并没有一个定数。我认为,如果某个操作比较简单、无需太多思考过程,「一针见血」往往更好;而如果需要体现解决某个问题的思考过程,「娓娓道来」更合适一些。

但我觉得,无论如何都应该遵循一点:永远不要把教程写得比产品说明书还长!

(此处的产品说明书,主要针对电子设备的支持网页,如 Apple Support 上的说明内容。某些过短的迫真说明书,不在讨论范围。)