写技术文的三个原则是什么?

更新日期: 2019-08-28阅读: 1.8k标签: 技术

我关注了很多技术类的公众号,看着大佬的公众号几千的阅读量,甚是羡慕,这直接导致了我没有心情减肥,甚至多吃了一个鸡腿。 要怎么才能写出一篇好技术文章,让读到的人感到身心舒畅,快速Get到想说的点,我想破了脑袋。

喜欢读我文章的人多少都和互联网行业沾边,像咱们这一行加班是常有的,看文章的时间也比较琐碎:蹲厕所、挤地铁、吃饭、睡前玩手机。基本就是这四个时间,不是正在做就是在去的路上,有木有?!

要在有限的几分钟里,让看的人能够流畅读完,并且掌握表达的点,是一个很有难度的事情。

我总结了一下,重点有三个:

  • 精简
  • 有趣
  • 成体系


精简

精简,就是不说废话,珍惜读者的时间,把注意力集中在关键知识点上,最好在文章开始就能点明主题。

绝不要大段的引用和铺概念,一旦出现这种情况,中间也没夹杂有趣的部分,很容易产生抵触情绪,这直接影响到阅读体验,像我这种爆脾气,要不是因为穷,直接就把手机摔地上了。


有趣

要让文章变得有趣起来,可读性强。

  • 发挥出全身上下的幽默细菌,适当写些段子无伤大雅,甚至可以加入一些故事情节,让人回味无穷。
  • 专业名词少用,说话越土越好越容易让人理解。别整天扯那些名词,又不是在写论文。
  • 有图千万别写字,有表格用表格,一张图胜过千言万语,当然了,能用动图就更棒了!

当然,有趣是建立在精简的基础上,又不是在写童话书,突出重点,把握好火候。


成体系

我看到很多大神技术水平很强,但是喜欢站在自己的角度上说技术,别人基本没办法看懂,写出来的文章也只能自己看。

在这里我特别想说,当我们在看一篇文章或一本书的时候,看个几行心里面产生一种情绪,“啊,太难了,我好菜啊!” 这不是我们的错,而是写文章的人的问题。

写技术文章不是写流水帐,要有脉络,从易到难,循序渐进,针对一个新概念要想清楚表达的方式。拆分难的知识点成小块,最后再联系起来。让人一下子看懂,成就感满满!我比较喜欢问自己:

what ? 我要讲的点是个什么东西? 

why? 这个东东能做点什么,有什么用?

how? 要怎么做才能用上(实现)

本文章原创首发于公众号:编程三分钟
链接:https://blog.csdn.net/BTnode/article/details/101606641

链接: https://www.fly63.com/article/detial/5567

技术开发,如何与领导谈涨薪

归根结底,涨薪其实是达到自己价值与薪资的最佳匹配. 好比你就是一只股票,公司当然会选择那些估值远高于股指的股票. 所以唯有不断增长自己的价值,才会成为你在涨薪谈判中的重要筹码.

bt种子简介与magnet磁力介绍

BT下载相信老司机们都接触过,为什么BT种子会慢慢被磁链取而代之?它们都可以用于BT下载,除了文件和字符串这表面上的区别,背后的技术上又有何不同?

WebService的两种方式SOAP和REST,之间的区别与优缺点

SOAP用于在Web Service中把远程调用和返回封装成机器可读的格式化数据。REST形式上应该表述为客户端通过申请资源来实现状态的转换,在这个角度系统可以看成一台虚拟的状态机。

工作了四五年,感觉技术上依旧长进不大

技术精进是一个持续增长的过程,而非一朝一夕,即便你在最短时间的掌握了大量的技术点,如何不及时应用到实际问题中,也很容易被遗忘。有朋友会说,我平时也挺努力的,一直不间断的学习

在阿里做了五年技术主管,我有话想说

今天的文章,他将继续深入探讨这一话题,从管理的角度分享技术TL的核心职责,主要包括团队建设、团队管理、团队文化、沟通与辅导、招聘与解雇等,希望与大家共同探讨、交流。

你和阿里员工的技术水平到底差几个等级

根据近年数据,中国现有程序员500万左右,其中P1、P2数量占据了近100万,P8及以下程序员约有490万,P9及以上仅有10万。80后是企业的技术支柱,90后已开始逐步成为企业的中坚力量

程序员常逛的技术社区

技术的成长路上,少不了跟一些志同道合的人交流,阅读一些技术前辈们的经验分享。这一路走来,还是要感谢有技术社区的陪伴,让码字之余,在技术、以及技术以外,都有不少收获。

未来,哪些技术在前端开发的地位会越来越高?

过去的这段时间里,不论是互联网巨头还是初创企业,都纷纷进行了一波优化。渐趋理智的资本淘汰了一批不能适应市场的业务,而业务的紧缩也淘汰了一批不能适应市场的程序员。

合格PHP程序员应该掌握哪些技术?

除了能够完成基本的PHP业务开发,还能够解决大部分深入复杂的技术问题,并且可以独立设计完成中大型的系统设计和开发工作;自己能够独立hold深入某个技术方向,在这块比较专业

技术追求的误区[观点与思考]

认识的一个 10 人左右的团队,本来是用 PHP 的,这些年看到网上很多用 / 转 Go 的消息,于是团队里有不少人就焦虑了,希望找一个合适的切入时间,能够试一把 Go

点击更多...

内容以共享、参考、研究为目的,不存在任何商业目的。其版权属原作者所有,如有侵权或违规,请与小编联系!情况属实本人将予以删除!