技术写作是有技巧的
记得2013年9月1日,我开始在“开源中国”上发表博客,两年内我写了很多文章,同时也做了自己创立的开源项目,还认识了很多志同道合的朋友,最后也给自己带来了前所未有的机遇。感谢开源中国,它给我提供了一个很好的平台,让我可以在这个平台上尽情地发挥自己的价值。 其实我在写第一篇博客之前,就在纠结到底要不要写?自己能不能写好?如果写得不好,会不会被人“喷”?总之,都是一些负面的情绪,让自己没有勇气动手去做这件事情。 记得那是一个周末下午,不知道为了什么,我和老婆怄气了,可能是因为小孩刚刚出生,每天哭哭啼啼的闹个不停,我们都被折磨的心力憔悴。老婆在客厅里发飙,小孩在床上哭泣,我坐在卧室里对着“开源中国”网站首页发呆。 不知道自己是受了什么刺激,点击了开源中国网站上的“写博客”按钮,于是轻描淡写地完成了以下这篇短文: Smart Framework:轻量级 Java Web 框架 从此,自己的技术写作之路就根本停不下来。 坦率地说,当时写这篇文章时,我心里是没底的。因为文章中所描述的这是一款开源技术框架,我只是对此框架提了几点需求而已,当时根本就没有一行代码,怎么能叫“开源项目”呢?我告诉身边的朋友: 开源并非只是源代码的开放,而是思想的开放。 因此,我首先开放了自己的思想,然后才开放了自己的代码。具体过程是这样的,首先通过思想去和大家交换意见,然后得出合理的结论,最后产生具体的代码