如何规范自己的技术博客

前言:

       一篇好的技术博客是表述自己的思想,传递自己总结的知识,与同行业分享成果,进行技术交流最佳的方式。不仅可以把以前使用过的内容从记忆的海洋中找寻出来,提高工作学习效率;而且是对零碎知识点的积累和深究,可以发现潜在的、遗留的或技术瓶颈的历史问题;再者IT技术日新月异,虚拟化、云计算、大数据时代已强势登陆,通过技术博客可以了解行业动态,提升技术方面眼界。

规范点:

一、技术博客有自己的特色

        网上转载的技术博客对自已未必是最好的,并且转载后时间一长该话题就不再问津了。形成自己的风格是提高个人兴趣的手段,可以快速的从自己的思路中恢复过来。它也是自我学习和体会的最佳方式,一个技术问题转载只需手指一弹,写技术博客需数小时之久,其过程的细节、关键点只有亲手实践才更清晰明白。并且同样的知识点、同样的问题每个人见解、想法、思路都是各见千秋的。

二、技术博客图文并茂

      一幅图能很好的表达自己的思想,有时好图胜过偌大篇幅的晦涩代码。整体的架构图、部署图、继承关系图、流程图都是很好的方法,不仅让结构过程清晰而且更吸引读者。代码毕竟是实现过程,而不是原理。

三、有目标性和系统性

      要明确每篇博客的目标,不是简单的罗列大堆的文字代码,要明确目的,明确解决了哪些技术难题。要判断自己所写的东西是否有价值。

      对每个知识点尽量做到系统性和深入性,博客是花时间求知识,若只追求数量没有质量是得不偿失的,要做就做最好的。如果时间和兴趣都有的话,可以一个专题整体发布博客,当然是有些挑战和难度的。一篇博客讲述一个问题,要多联系实际,以主题为中心,构建清晰的脉络结构。

四、分享源码

    分享是一种美德,分享自己的成果是一种成就感,分享自己的过程是一种超越感。你分享的内容越多,自我所需要掌握提升的也会更多,自我提升的压力动力也就越多。源码是理解思想最佳的方式,是很重要的资源积累。

五、专业化

     博客是技术的总结和提高,不是解决问题的过程,不必要列出所有的测试、解决、实践方法,只需列出关键的节点。要想掌握一项技术、知识,需要一个过程:实践遇到问题---理论学习问题---实践解决问题---理论总结问题---问题提升,循环往复,不断上升。总结前人写博客步骤:(1)碰到有价值的问题(工作、书本、网上课题),记录作为博客的开篇。(2)分析解决问题,记录好问题解决的方案和可能的思路。(3)画出部分的流程图、结构图,其他的可以在完成代码后在设计。(4)落实到代码的实现,测试并发布完整的程序。(5)总结,写技术博客。

     找资料最好用google,百度只是大众化的不适合技术研究,下载源码、找问题根源最好从官方网站查询,别人的博客虽只是别人主观遇到的问题,有时会浪费大量的成品和时间。

     英文文章的水平整体高于中文文章水平,应该尽量强迫自己看英文文章。

     写一篇好的技术文档是一个专业软件工程师的必要素养,我们不仅要写出漂亮的代码而且要使写的技术文档越来越专业。

五、不断打补丁

     技术博客中肯定会遗留问题或与网友沟通后出现新的bug,也或技术的更新带来的不兼容,那我们要时时更新。最好不要修改原来写的技术博客,要以补丁patch的形式汇总,这样可以很清晰的查阅更新的内容、明白技术的变更。

总结:

    以上规范约束自己的博客质量,以求做的比较完善,以提升技术为主要出发点。

你可能感兴趣的:(技术)