我觉得帮助文档应该有的东西
最近看thinkPHP (http://www.thinkphp.cn)看的比较多,ThinkPHP框架做的确实很方便,减少了开发者很多的困难,而且文档也比较齐全,确实是国内最用心做的框架之一了,只不过在学习的过程中,仍然发现了一些不足,特别是在帮助文档上,感觉总是心里痒痒的,在这里讨论下.
1、一个帮助手册最好能提供“名词速查”
在学习ThinkPHP 的过程当中,会遇见很多感觉很混淆的名词,比如“模块”与”Action”,按照我的理解,模块应该类似asp.net mvc 中的Controller,在ThinkPHP中Action类 就是模块 我挺费解的,如果说直接有个表,指出了一系列名词都代表什么意思,那就ok了。
2、官方demo是可以稍微讲解下
感觉ThinkPHP 里的官方实例基本把ThinkPHP 里的所有东西都涵盖了,可惜美中不足的是首先注释比较少,第二,全程无讲解,作为一个刚入门的初学者,我觉得如果说有个文档引导下demo,则效果会更好。
3、互动的帮助文档
这点ThinkPHP做出了第一步,http://doc.thinkphp.cn/manual/ 里开放了用户的留言,备注,但是查看这些留言,备注实在是太麻烦了。。。。。。而且似乎不能搜索自己的备注,这真是个遗憾哇。
就这么多了,以后慢慢讨论