查看原文
其他

如何维护一个好的技术博客?

老刘 码农翻身 2018-10-25

之前写过一篇文章,叫做《对自己狠一点,开始写作吧》,说的是写作的好处,有不少人响应号召,按捺开始不住动手写了。 


最近和几位同学交流,聊起他们的技术博客,说总是没什么人看,没什么反馈,慢慢地就没有动力更新了。


我相信这不是个例,很多程序员都想在互联网上建立自己的个人品牌,比如说在github上拥有一个属于自己的热门项目;或者自己维护一个读者很多的、活跃的微信公众号/博客,这些东西对自己的职业发展大有好处,写到简历中对找工作尤其有帮助。


但是实践起来就会发现困难重重。拿我自己来说,我在github上面没有正式的项目, 只是维护了一个阅读量还算可以的微信公众号, 我给大家分享下我这两年的经验。


1

时刻考虑对读者有价值,而不是自己很爽


现在有不少文章,都是把自己的经验,自己工作中遇到一些技术点、解决的问题一股脑地写出来,不分主次,自己觉得很爽,似乎面面俱到,但别人读起来不知所云。


还有很多文章,采用的是bottom-up 的方法,上来就罗列技术细节、具体参数、安装步骤,很容易把人给搞晕、让人心生厌烦。


我建议大家写文档的时候采用top-down的思路,先讲why ,再讲how,甚至把更多的笔墨放在why 上,让读者了解背景,问题产生的原因,有哪些可能的解决方案,哪些方案较好。这么一路下来,也能帮助你自己理清思路,甚至帮你发现自己理解的漏洞。


2

要有自己的特色


现在的互联网上,文档的同质化非常严重。


同样一个主题,你只要一搜,就会出现成百上千个文档。


如果你不想和别人雷同,可以考虑去写一些新的技术,但这些技术都是发源于美国,在我们知道这些技术之前,已经有很多英文的资料了。


你也可以尝试去做翻译,这也是一个不错的路子。只要你翻译的质量比较高,大家喜欢看也是非常好的。


如果不是新技术,那你就需要思考这些问题:

网上也有大把同样主题的文档了,我为什么要再写一遍呢? 我写的东西和现有的文档有什么不同呢?


这里的关键点就是特色


比如说你写的文档,极大地降低了阅读者理解的难度;


或者说你把某个技术领域的文档做了整理,形成了一个大全的东西,非常的完备和详尽,对大家很有帮助,别人想查找什么东西就会到你这边来;


再比如,你对某个技术写了一个对入门者非常友好的文档。让大家轻松入门。


拿我的微信公众号码农翻身来举例吧,我把它定位成用故事讲解技术,并且是通俗易懂地讲解技术。我也见过好几个公众号是用漫画或者简单漫画的方式,去讲解一个东西,都算特色。


总之,在这个严重同质化的年代里,努力要让别人一提到某个东西就能想起你,这就是特色。


怎么才能形成自己的特色呢?


我在这里肯定没有办法告诉你,每个人都不同,需要你自己去想,去思考,去尝试。你可能会失败,也有可能无意中找到一条自己的路。


所以你看,想做出一点与众不同的东西,关键还是要创新。创新并不是一个虚头巴脑的词,它就在你的身边。


3

要坚持,持续不断地输出


这是最重要的一点,要坚持,要持续不断地输出。


也许你写了很多,但是仍然无人问津。


没有正反馈,确实难以坚持下去。


没有读者回复,没有读者搭理,似乎在孤芳自赏。


但你一直在默默地坚持,坚持对用户的价值,坚持自己的特色。


某一天,你的某一篇文章突然成了爆款,引发了传播。大家都关注你了,读者源源而来,这样正循环就形成了。


如果你觉得自己写得不错,我可以帮你传播下,不仅传播,还有稿费哦。


热烈欢迎大家向码农翻身公众号投稿,稿费每篇400元(需在码农翻身标记为原创)。


要求:

1. 原创

2. 通俗易懂地讲述技术知识,采用top-down的方式讲解一个技术点,不要罗列技术细节、具体参数、安装步骤。

3. 可以分享自己求职、面试等经历;分享自己的职场经验, 感情故事更加欢迎


可以在文章中加上个人的介绍,网站链接等,增加你的知名度。


下面是几个已经推送的投稿文章,大家感受下:

图解冒泡排序

工作六年,半路出家到CTO

为什么能力优秀的人当了主管以后反而不行了呢?

函数式编程圣经


有意投稿者请联系我,微信:liuxinlehan 

    您可能也对以下帖子感兴趣

    文章有问题?点此查看未经处理的缓存