撰写个人技术博客心得体会

  作为一个初来乍到博客园的小白,看到一群大牛能够在博客园分享自己平时技术上遇到的问题和解决方法,或者是畅谈一些经验,就觉得很是厉害。倘若我也能够拥有自己的一群博客粉丝,然后能定期地写一些文章,看到有人在下面评论“对我很有帮助”,这该是一件多么有成就感的事情。所以,想要从头开始写博客,就要学习大牛们的博客是怎样撰写的,有没有什么共同的特点。在浏览了一些有关“软件工程”有关的技术博客和如何写个人博客的随笔后,我大致总结了以下几点方法,也希望这些方法对其他人有所帮助~

1. 标题应该清晰明确

  标题可以说是一个门户的作用,是让读者了解到文章的内容主旨的一个标识。如果标题起得不好,就很难引起别人的兴趣,更不必说高阅读量了,即使是文章的内容质量很好。

  标题确定下来后,要多查找些资料,因为不同的人可能对同一个事物有不同的看法,所以通过阅读和整理多个人对同一事件的描述可以让自己更深刻,更多角度地理解这个问题,然后再结合自己的理解,就会理解的很快,也比较透彻。

2. 明确目标和受众

  确定好标题后就需要确定你的目标读者群体。了解你的读者群体是极其重要的一步,他们是怎么样的人,有什么背景知识(或者你希望你的读者群体需要什么知识),这些人需要什么思维方式。这是极其重要的一步,最好是能够把你对读者的要求写在文章的前面,这样对你和读者都有好处。了解目标群体就像产品经理了解目标用户需求,切身体会到了才能做出好的产品。

3、不要重复文档,给出链接就好。

‘Do not replace documents,link to it.’ 重点是写自己的心得,体会和总结。对于那些在官方文档中都讲的很清楚的东西就没有必要再进行重复了,给出相应的链接就好了。特别是对于像MSDN这种非常丰富的官方文档,最好不要去重复它的内容,因为你不一定比官方讲的清楚。重点应该放在自己的心得,体会和总结等,这样于自己是真正的总结和积累,能变成经验,于他人也是一种有价值的参考的。比如:

  • 把所有可靠的方法都说一下;
  • 把注意事项说一下;
  • 把各种方法进行比较,给出各自的优缺点和适用场合;
  • 文档中没有说明的情况,比如对文档的补充,或者文档有自相矛盾的地方。

4、必须亲自实践进行验证,确保可靠可行。并附上实例(源码,资源)和运行结果(截图等)

  当我在安装一些软件像Eclipse和Android Studio时,就会上网搜索有关安装教程的博客。我会挑选那种一步一步地,有截图和文字说明十分详细的教程。因为之前也上过一些当,点开一个安装教程照着做,但作者有些步骤直接跳过,导致我在在安装时遇到一些问题。所以自己写某些技术博客时,要尽量以一种babysitting的态度,对于专业术语,要用通俗易懂的平实的语言讲出来,如:

  • 多用比喻,用大家熟悉的东西来比喻,这是让人们最容易理解的一种方式。比如把软件构建比作建房子;把软件架构师比作楼房的设计师等。
  • 多用图示,用图解。很多时候一张图能抵上几百字的文字叙述,但还不一定能说明白。给出一张图就什么都明明白白了。
  • 图文并茂是讲解的最佳方式,合理的安排图片,再加之文字描述会达到事半功倍的效果。

5、内容精而深

  讲的越详细越好,范围越小越好,但要深入的讲,正如那句话,十个百分之十不如一个百分之百。如果你不能深入的讲,证明你还没有到写的时候,应试再去学习或者实践,直到你能讲的很清楚,讲的很详细,讲的很深入的时候再来总结和写博客。争取做到一篇文章一个点,这样文章多了就成了网最后变成没有漏洞的面。

6、突出主题,分清主次,逻辑清楚,层次分明

  这可能是对于写作的通用要求,说起来容易,但是做起来就比较困难。其实也不难,主要表现在:

  • 列表来罗列要讲的东西
  • 用标题先简明概括,然后再详细讲解
  • 标题与正文用不同的字体样式标识
  • 用字体和缩进来标识标题和正文

  编程技术这就好比写完代码后的调试与测试。好代码是改出来的,好文章也是如此。能够一蹴而就的人有,但很少。

 

7、最好能有版本控制信息和修订记录

  对于代码我们都有版本控制系统来帮助维护修改记录。但对于文档,也建议这样做。对于博客,可能没有(或许我不知道)类似的工具,但可以手动来说明。比如在博客的头部或尾部加上修订历史记录,或者在文章中把后来的修改用其他字体标明,或者用括号或脚注来说明。这样自已日后看起来也很方便,也能看到自己的思考过程和成长过程。如下图为一篇随笔中在开头声明的操作环境。

 

8、获得反馈并进行迭代

  当有一定阅读量后,跟读者互动交流后,就会发现文章不足之处,此时就应该及时修改过来。等过了段时间,写过的文章也应该经常拿出来温习,此时可能能力较之前有所进步,看问题更深刻,觉得不满意的旧文章也应该进行迭代。

 

以上就是我个人总结出来的一些方法,也是我第一次撰写个人博客,有不足的地方还请大家多多包涵~

猜你喜欢

转载自www.cnblogs.com/Shirley-Wu/p/12436225.html
今日推荐