我是在cdsn上发表的注册一个账号,发表博客.
一 从格式上来说:(1) 每篇日记标题前必须加上“黑马程序员”。
(2) Java日记书写规范,请将以下代码复制到每篇日记开始处:
------- <a target="blank">android培训</a>、<a target="blank">java培训</a>、期待与您交流! ----------
(3) .Net日记书写规范,请将以下代码复制到每篇日记开始处:
------- <a target="blank">Windows Phone 7手机开发</a>、<a target="blank">.Net培训</a>期待与您交流! ----------
二 内容上说:
采用面向对象的 “可维护、可扩展、可复用、灵活性好” 原则。
“可维护”——我们写博客应该打包归类,就像,博客并不是越长越好,而是“耦合性”越弱越好,就像类一样,并不是越长越好,而是耦合性越低越好,这样既给人一种清新的感觉,而且,试想一下,自己平时看文章是什么状态,有多少次能把长篇大论看完,恐怕只拉了拉下拉箭头就直接关掉的也不在少数吧。
“可扩展”——我这里所说得可扩展,是指博客要扩展,也就是要升华,不能仅仅拘泥也技术而无法自拔,学会扩展性的思维,想想,这种技术能升华出什么思想,每一种技术都是智慧的结晶,当然,编程更是,不是有句话说:“编程不仅仅是门技术,更是门艺术”吗,他必然有它的优越性,把他的思想升华出来,完成扩展功能。
“可复用”——思想上的可复用,无论学什么,其实都可以升华出一些一样的东西,这些东西在以后的学习中会起到很重要的作用,就像总结看书经验一样,基本上所以的书都是第一遍略读,大概知其然,然后如果觉得值得读,在细读第二遍,知其所以然,这就是经验,傻话总是同时踏进同一条河流,其实他缺少的,就是不能“复用经验,复用思想”,我们不要在反反复复的学习中(既是所学的内容不一样)去反反复复去犯同一个错误,而唯一能避免的,就是提炼出来,发表成博客(或者自己留着,嘿嘿,达到目的就好),让这些思想在不断的总结中不断加固,最终达到目的。
“灵活性好”——每一篇博客都要有自己的思想,这种思想是可以复用的,不仅仅是对于以后的学习,既是在生活中也回用到很多,就像大话里面的例子,几乎都是来源于生活,世界上最灵活的莫过于思想,所以,让自己的博客充满灵性,别人才能从你的博客中读出不一样的东西。
只有注入思想的博客才是好的博客,让你的博客活起来吧!!!
三 注意事项:
1. Do not Repeat Documents, link to it 不要重复文档,给出链接就好。重点写自己的心得,体会和总结。对于那些在官方文档中都讲的很清楚的东西就没有必要再进行重复了,给出相应的链接就好了。特别是对于像MSDN这种非常丰富的官方文档,最好不要去重复它的内容,因为你不一定比官方讲的清楚。重点应该放在自己的心得,体会和总结等,这样于自己是真正的总结和积累,能变成经验,于他人也是一种有价值的参考的。 2. 进行全面的总结前面说了不要重复文档,那应该写什么呢?愚认为,应该是自己经过实践之后的总结: - 文档中没有说明的情况,比如对文档的补充,或者文档有自相矛盾的地方。
3. 必须亲自实践进行验证,确保可靠可行。并附上实例(源码,资源)和运行结果(截图等)4. 要总结与所谈内容相关且有价值的网络资料5. 要列出参考资料,比如官方文档,别人的博客,源码等。这是对别人的尊重,也是对知识的一种尊重。6. 可以参考,可以引用,但不要照搬,不思考式的抄袭。最重要的是要有自己的思考和理解。如果是受他人的博客或代码的启发,最好把关键的句子段落引用出来,然后再写自己的思考和讨论。在文章中再给出原文或出处的链接,这样以显得尊重和专业。 7. 最好能有版本控制信息和修订记录对于代码我们都有版本控制系统来帮助维护修改记录。但对于文档,也建议这样做。对于博客,可能没有(或许我不知道)类似的工具,但可以手动来说明。比如在博客的头部或尾部加上修订历史记录,或者在文章中把后来的修改用其他字体标明,或者用括号或脚注来说明。这样自已日后看起来也很方便,也能看到自己的思考过程和成长过程。 8. Less But Better精深原则讲的越详细越好,范围越小越好,但要深入的讲,正如那句话,十个百分之十不如一个百分之百。如果你不能深入的讲,证明你还没有到写的时候,应试再去学习或者实践,直到你能讲的很清楚,讲的很详细,讲的很深入的时候再来总结和写博客。争取做到一篇文章一个点,这样文章多了就成了网最后变成没有漏洞的面。 9. 突出主题,分清主次,逻辑清楚,层次分明这可能是对于写作的通用要求,说起来容易,但是做起来就比较困难。其实也不难,主要表现在: - 列表来罗列要讲的东西
- 用标题先简明概括,然后再详细讲解
- 标题与正文用不同的字体样式标识
- 用字体和缩进来标识标题和正文
有没有一种感觉,这好像是在讲编码规范,没错,很早就有人讲过,写文章跟写代码是一样的。所以,作为程序员的我们,可以考虑用写代码的一切,包括习惯,规范来写文章。 10. 写完后多读几遍,进行校改这就好比写完代码后的调试与测试。好代码是改出来的,好文章也是如此。能够一蹴而就的人有,但很少。即使是像鲁迅那样的大作家写文章都还需要修改,都没有一次成型的,更何况我们呢?在写完文章后也视情况对文章进行调试和重构,直到自己读起来感到满意和舒服为止。试想,如果自己写的文章自已都不想看,别人会看吗?我们又不是在写作业,不管好坏老师总会看,而且要仔细的看。要想写出好文章,必须首先让自己认为是好文章。 11. 用通俗易懂的平实的语言,对于专业术语要解释好的技术文章应该都非常容易看懂,即使你对所说的那门科学完全不知。去读一读《Code Complete》等之类的经典书籍的英文原版,你会发现,其实看原版书并不需要多么NB的英语水平,可以不客气的讲上过大学的人应该都能看懂。其实这重点不在你懂不懂英语,而是要看作者能否用最易懂的语言来把事情表达清楚。这确实是一种能力,平常我们所谓的沟通能力,也基本上就在这,看你能否用最简单的语言把事情表达清楚,让另一方听明白。 这里有一些技巧: - 多用比喻,用大家熟悉的东西来比喻,这是让人最容易理解的一种方式。比如把软件构建比作建房子;把软件架构师比作楼房的设计师等。
- 多用图示,用图解。很多时候一张图能抵上几百字的文字叙述,但还不一定能说明白。给出一张图就什么都明明白白了。
- 图文并茂是讲解的最佳方式,合理的安排图片,再加之文字描述会达到事半功倍的效果。
12. 用事实说话有图有真相,有代码有真相。说完了,讲过了,最好附上真实事例,代码和截图。否则别人可能会质疑,至少我在看到别人只“说”,没“做”的时候会质疑的。
|