如何写技术博客

关于如何写技术博客网络上有着无数个版本,每个人都有自己的见解,想写一篇这样的文章已经很久了,但是一直不知道如何出手。之所以不知道该如何落笔,一方面是因为我知道这样的文章很容易引起口水战,这是我最讨厌的事情,另一方面是让人感觉自己好为人师,虽然自己对技术也有一些积累和心得,但是由于自己就是一个讨厌别人告诉自己该干什么干什么的人,己之不欲,勿施于人,所以一直迟迟不得落笔。

直到今天,无意间在网上看到了一篇文档,这篇文档叫“跟我一起写make file”,作者是酷壳的陈皓,文档不算短,pdf版本的有78页。刚开始我只是随便看看,但是慢慢的,我发现这篇文章写的太好了,由于个人对make file之前有所了解,一口气花了5个小时的时间看完了这篇文章,但是并不觉得累,原因很简单,文章写的非常通俗易懂,完全是人家心得的东西,一看就是行家离手。

看完这篇文章,我觉得我该说些什么,关于写技术博客的。

首先,什么样的东西应该写,什么样的东西不该写?

说这个可能会刺痛很多人的神经,有句话是这么说的:学比处于心得,业必归于专精

如果不是自己有所心得,那么还是不要写了,不仅自己没有收获,浪费了时间,对比人也没有帮助。

第二,当自己写博客的时候问自己一个问题?对于要写的东西,我自己吃透了么,写博客不是stackoverflow, 不是向别人问问题,通常是自己要阐述某个方面自己的心得,当然并不是说不可以讨论,但是讨论的前提是you have the knowledge。

第三,对于一篇博文的定位,是知识梳理的,或者新技术的,或者难点易错的解析等等,定位好了才容易使一篇文章短小精悍,有形有神。

第四,对于博文标配的代码,最好带注释,你是在写文章,不是在写代码,好多人就直接贴一屏的代码,就成了一片博文,难以理解。

第五,在对于博文阐述的技术进行交流的时候,要尽量避免不礼貌的行为,有些博文的作者文章写的还行,但是每每和别人交流的时候就动辄骂娘,个人觉得很是不和谐,当然也可能事出有因,在此只是提出来,建议大家不要这样做。

第六,对于写博文是某些博主的炫技(就像有钱人炫富),这种炫技是本来很简单的东西,可能别人只不过是没接触过,作者却把整个东西写的很复杂,其实他心里很清楚,只不过是故意写的很深奥,显得自己很牛。

总结

当然作为写博客不应该有的情况还有很多种,在此不可能穷举出来,在某些方面我自己也做得不够好,写这篇文章算是对自己的总结和警示,当然也希望大家也思考一下该如何写技术博客,另外,对于文章中提及的情况,请不要对号入座。最后因为本人讨厌口水战,所有如果是沟通交流,欢迎指教,如果是口水战,请绕道,对不起,对于没意义的事情,兄弟没时间。

原文地址:https://www.cnblogs.com/lichengze/p/5596437.html