好文章与坏文章


看到这个标题,不要误解。我并不是为了给文章打一个非好及坏标签,我也没这个能力打标签。这里先说下本文说的文章的范围,主要是针对技术领域的内容。所以这里的好文章,更精确的定义应该是让想要学习这个领域的人,能够更容易理解的文章。不过初学者不容易理解的文章就是坏文章么?那当然不是,但是针对于这个人群来说,这类文章的价值意义肯定比不过”好文章”。

技术类的文章和书籍自己阅读过不少,下面就谈谈关于”好文章和坏文章”的几点心得和看法。

有自己的观点,不要人云亦云

我经常会看到,有一些技术文章来教大家的安装过程。并不是说这类文章没有意义,而是说这类文章和技术文档其实没什么大的区别。如果能在介绍安装步骤的过程中,讲解下为何要这样安装其实就很有意义了,而不是简单的记流水账。

还有一类文章,就是翻译的文章,往往容易出现坏文章。因为译者的话毕竟不是作者,一些观点理解难免有误差。再加上如果这个领域不了解的话,就会更加的糟糕。相信你一定读过翻译很烂的技术文章。我下面举一个例子。

This is an opaque data type and use xxx api accessed directly.

很多技术文章的翻译是,”这是一种不透明的数据类型,使用xxx来访问”。transparent or opaque type这两个词在英语中形容一些实物挺形象,但是翻译出来,如果译者不加思考的直译的话,对初学者来讲真的很难理解。如果能补充一句说,”这是一种不透明的数据类型,也就是具体的数据结构没有公开方法,只能通过xxx api来访问”。这种就好理解多了。所以如果翻译的文章,没有吃透作者表达的原理,就很容易人云亦云,照着字面意思翻译。

不需要整的高大上,简单就好

有些技术博客,特别是讲架构的技术博客。上来就是kafka dubbo zookeeper各种新概念。然后复杂无比的架构图一展示,然后使用各种专业名词解释xxxRPC进行模块间通信,相信这类文章也会遇到不少。这类文章我想说的是,到底是讲给谁听的,如果是讲给想了解这个领域的人听的,别人可能看了几个名词后,就会去搜索这个名词了,然后也不见得会回来再读。讲给这个领域的专家,可能看了开头也不会读下去,不知道到底要表达什么。

所以写技术文章一定要有个核心,比如讲某个架构是要解决什么问题,可以把问题先定义清楚。因为问题往往比较简答,比如说用户量过大,单台服务器无法满足要求,想动态扩展。然后再来讲架构,讲架构的时候特别遇到一些新的名词时,如果能表述下这个新事物的来龙去脉,发展历程那就很容易吸引读者。

技术文章不需要一下子讲完所有的东西,只要抓住一个点讲解清楚就完成了任务,因为一个人看一篇文章往往也不会理解太多的东西。所以文章不在于多,在与精简。

能够融会贯通的,一定是好文章

什么是融会贯通,就是能把一个复杂的东西,通过一些身边常见的例子,很简单的表述出来了,这就叫融会贯通。很多作者在讲解一个技术点时,自己确实理解的也很透彻,但是讲给别人听的时候,就复杂无比,别人听的云里雾里,这其中就没有把握讲解的核心”大道至简”。

我这里想吐槽的是很多数学类的书籍,尤其教科书简直就是劝退的书籍。举个线性代数的例子,一上来就把矩阵的式子列出来,然后各种变换的方法讲解起来。上大学的时候读这种书时,我就怀疑人生了,这到底是要干嘛,学这些有什么用。可是当我读到一本叫《漫画傅里叶变换》这本书的时候,书中一开始并没有解释数学公式,而是从两个音乐系的学生在争论一些乐器的声音开始,然后逐步解释了傅里叶变换公式的推导。当时我读完的时候,真是茅厕顿开,解答了困惑自己很多的问题,也明白了这些数学公式到底有什么用。

所以数学其实很多公式都是很有趣的,设计的非常精妙。只是我们讲解的时候,都是死板的按照公式来的,根本没有结合实际应用融会贯通。造成很多概念极其抽象,完全没有现实中类比的对象。

能够讲故事的,一定也是好文章

自己曾经读到过一篇公众号的文章《我是一个线程》。通过讲解一个人在工厂里工作的经历,描述了一个线程的创建,运行和销毁。我感觉讲的非常的好。通过类比我们身边常见的故事,讲解一些晦涩的技术感念,非常的巧妙。对于初学者来讲,通过这种类比,就很容易理解。

最近也看了《我是一个线程》作者出的《码农翻身》这本书,自己也在学习作者的讲解方法。尤其书中通过漫画和实例相结合的方式,讲解的非常的生动。这类文章就是通过一些有趣的故事,然后就把一个技术点的来龙去脉分析的非常透彻。并且故事和技术点的结合也非常的贴切,这其实需要作者大量的思考才能总结出来这些方法。所以好的文章,不仅需要你理解这个技术点,同时也要很好的能讲解这个技术点。

总结

个人觉得进入一个行业的门槛,跟这个行业的教育水平有很大的关系。其实我觉得IT行业就挺好,有大量高质量的文章和资料输出。只有这样的文章多起来,才能更好的让初学者进入这一行。我在想例如数学和物理一些理论学科,如果能有更多高质量和有趣的讲解,相信这两门学科比我们想象的有趣多了。

如果你喜欢这篇文章,谢谢你的赞赏

图3

如有疑问请联系我