写blog注意的小细节

    写blog也有一年多了,不能说笔者blog或者技术多好,但是在如何写blog上却是有笔者的一些见解。无论各位是新手,还是技术大牛,都会写一些blog来记录自己的经历。都有自己的写作风格,以下只是笔者个人观点。

    1.别人写过的blog,请不要再写了。如今,我们在查找资料的时候大多是借用搜索引擎,搜索引擎做的很好,但它有时也不能把所有相同的内容过滤掉。所以当我们google某个内容的时候,有时第一页显示出来的内容都是一样的。要么是不同的人写的; 要么是一个人写的一份,在几个不同的blog网站上贴出来。笔者个人很不喜欢这样的行为。幻想一下,当各位去搜某个内容的时候,半天都是相同的内容,各位看官的心情如何呢?我们发的每一篇文章要有质量(不要抬杠啦,笔者的blog质量不高啦),而不是要在乎自己发表blog的数量。而如果各位同时维护着几个不同的blog,不觉的累吗?那干脆自己做个blog站点好啦,凭你的技术不算难吧?

    2.不要翻译guide。原因如下:某些技术的文章,都会对应一个cn的guide,如果没有,各位大可考虑和官方联系一下,建立一个中文的guide文档的站点,或者贡献你的力量。另外,如果一个技术人,连一篇英文文档都读不懂的话,那只能说他只是一个coder。这话没有任何瞧不起其他程序员的意思,笔者也是程序员,但是程序员要去自学,要去查文档,而不是墨守城规。文档还是官方的好,因为总感觉翻译过来的文档已经变味了。

    3.整理写作的逻辑思维,先干什么,再干什么,中间可能出现什么问题。这时候程序员就像是一名老师,不单单要教会别人技术,而且要告诉别人你思考问题的思路。阅读的人,觉得你的思路好,可以兼容学习;觉得不好,大可不去学。有则改之,无则加冕。

    4.优化你的代码结构。我很讨厌去某些网站上去看文章,因为这些网站上的blog没有采用markdown。这也是我为什么选择iteye来写blog,看中的就是markdown。同事在xx网上写blog,通通没有采用markdown,我问为什么,有的说,没提供;有的说,有,不好使。总归是没有。看了有些博主的文章。代码之间连换行都没有,这样的文章如果是博主自己看,可能会明白。如果是别人呢?也能明白,只不过费点力罢了。

    5.不要罗列内容。有人喜欢把blog作为自己记录自己成长点滴的地方。我们应该鼓励,但罗列学习的内容是没有意义的。比如今天学习了javasript,学习了它的string,有xx方法;学习了array, 有yy方法。这有什么意义呢?方便别人查api吗?这个官方api我觉得比你写的好。个人认为,blog的内容应该是自己学习的感想,感悟,学习的方法。

    6.不要翻译api。貌似和前面的说的相似。但是这样的情况也很多。通篇在说某个对象的下面的函数,拜托,这些内容官方api上是有的。如果你想写的话,你可以写某个接口的深入剖析啊。实在想写的话,就写一个学习笔记好了。

     你是笔者,也是读者。总之,你写的blog,要让自己成为第一个读者,自己能够看着舒服。

猜你喜欢

转载自zhangfortune.iteye.com/blog/2004552