puny 作为一个技术类产品,layabox的文档写的不是很合理,没有具体引擎的新手文档,都是编辑器和UI组件的,示例的代码也很简单。而且api文档和示例代码有很多不一致的,让人很难理解。 对于整个引擎的框架结构也没有说明,对于想深入学习的人很难下手。 建议参考一下:https://cn.vuejs.org/,我觉得这个是国内少有的国人作品中文档比较优秀的
puny layabox 1、示例的代码很丰富,但是都是片断性的,没有一个完整的项目流程代码提供学习,哪怕只是一个简单的小游戏。我认为一个优秀的文档逻辑应该都是:先诠释项目的代码结构,其次完整的演示一个上手小项目,最后深入解释相关的技术原理。我觉得你们的文档这对于编辑器的使用诠释的过多了,更像是百度知道,或者百度经验这类的,不像是给程序员看的 2、比如说Loader这个类,api文档里面loader.load()传入的就是具体的object对象,而示例代码传入的就是包含多个对象的数组。