关于5.0手册的完善的建议

浏览:1597 发布日期:2016/02/17 分类:站务建议
一份贴心的用户手册,必定能为一个框架赢得大量的新粉丝,因为一个框架重点就在一个“用”字,毕竟使用框架的主要目的就是用来缩减学习和开发的成本和门槛,而用户手册在“用”这个字上具有决定性的指导意义。

原理和概念固然重要,对于学习来说的确非常有帮助,但它们并非是用户使用时的重点,除非需要进行大量的二次开发……如果用户十分关心底层是如何实现的,那使用框架的意义就不大了。在敏捷开发中,用户更关心的是框架各个功能在使用场景中的表现。

所以说,用户手册里每个条目都加入常见的使用场景说明是十分有必要的,否则写了一大堆原理和概念,新人可能依然根本不知道某个条目的功能可以用在什么地方,很多简便和实用的优秀功能在开发中就这么直接被忽略掉了,多可惜……

然而,如果有了常见的使用场景说明,新人马上就能很直观的理解其主要用途,并能举一反三,将其灵活运用在其它新的场景中,这样,框架所有的功能就能最大化的被使用。

一份贴心的框架手册,试图让用户了解的应该是:
用途 -> 概念 -> 原理

而非是:
原理 -> 概念 -> 用途

否则就本末倒置了……

新的一年,新的版本,祝thinkPHP越来越强!
最佳答案
评论( 相关
后面还有条评论,点击查看>>