+ -
当前位置:首页 → 问答吧 → 文档编写规范让你我他见档如面

文档编写规范让你我他见档如面

时间:2009-07-27

来源:互联网

上一期的活动由于工作太忙没有参加,事后非常的后悔很是郁闷!

由于我一直在菜鸟的水平上游走,没有什么长进!对于一些大型的项目、以及什么团队开发等都没有参与过,对于本节内容我只能是以学习者的角度来发表一下看好感。
从第一次编程的时候那些长靠们就告诉我要合理的规范编码,统一编写方式等等!!可是到目前为止我还是没有作到这些。

本节的刚开始讲的内容非常容易理解,就是告诉人们在编程过程中的按一个统一的规则行事,无规矩不成方圆嘛!但是有很多东西是没有办法统计的,比如个人的习惯、程序员的个人观点发及某种利益关系。就目前IT行业来说浏览器都还没有统一,W3C工作组成立这么多年了,订了这么多的规则文档,各浏览还是各作各的。这些都是题外话了,我只是想表达一下统一是很难的,分久必合,合久必分。

在编程过程的一些习惯,我一直都是按主流的规则行事。我想自己习惯就行没有必要去强行遵守某些组织提出的规则。如果您愿意你自己也可以发明一个规则,只要你认为你的规则是完美的。

还是说说本书的内容吧!看了一下本书的目录可以说是一本高级教程了,看了许多书好像没有比本书要高级的了,可以说涉及到目前比较流行的各种技术了,而且是图灵出版社出的书,这个不用多说了,在论坛上已经是有口皆脾的了,内容一定是过关的了。
看了本章感觉前面部分容易理解,后半部分有点难理解,因为我从来没有和过phpdoc和docbook的缘故吧!在总体上感觉还是非常不错的,内容也很吸引人,我现在还想在看一下关于API反射等内容呢!

另外感觉本书在介绍phpdoc命令的时候,说的可能是在linux或是unix环境下,刚开始没有说有点闷,没有听明白,后来看到下面就明白点了。

最后还是说一下作一个程序员一定要编写好文档,虽然我现在没有用到但是我想一定非常的重要,特别是在后期维护的时候。

作者: gvtbs   发布时间: 2009-07-27

说了不少费话!自己顶一下!!

作者: gvtbs   发布时间: 2009-07-27

我也顶一下

说了不少自己的情况,莫非是在相亲?

作者: cnkiller   发布时间: 2009-07-28

卡卡~~~我在反映读者情况

作者: gvtbs   发布时间: 2009-07-30