[]laya的框架做的挺好,但是文档不好好写,搜索和文档乱的一B,心寒

laya的框架做的挺好,但是文档不好好写,搜索和文档乱的一B,心寒
已邀请:

layabox

赞同来自:

layabox的搜索和文档的确有很大的优化和提升空间。目前我们这块的人力有限,很多更紧急的事要做,只能有空后慢慢优化。
但是,如果注意的话,文档也满足当前的需要。
 
第一、根据你反馈的信息看,应该是开发新手,API文档,更面向一些已熟悉其它领域,有过其它开发经验的开发者。这种API都是能看懂的。当然,肯定还是有优化空间的。不过对于新手,建议先把所有技术文档看完,结合DEMO示例再来看API.
 
第二、搜索,你指的是API里的搜索。这个搜索只是针对标题搜索。肯定不全,包括社区的搜索也不太全,推荐使用全文搜索。在开发者中心的网站导航上有搜索这两个字的导航。打开看一看。地址是:https://sou.layabox.com/
 
第三、LayaAir引擎是不区分语言的,语言只是基础语法的差别,对于引擎接口而言,API文档中没有太大的分开价值。在具体使用方面,可以参照技术文档。技术文档是实际应用,是区分语言了的。
 
第四、IDE设计模式,是非常显眼的图标。作为一个开发者为什么不先去对工具先研究一下。还有。技术文档中对工具有详细的介绍,为什么不去看技术文档?
 
 
 
 

youka

赞同来自:

1、整体布局就有很大问题,可以按照入门,框架,组件,API,IDE说明划分一下,类似微信开发文档这样布局,对应的文档对应demo,遇到问题可以一步就找到对应的教程
2、搜索简直烂到不行,目前你们匹配模式基本是搜什么都搜不到,而且js,ts,as糅杂在一起,至少可以分开不至于搜一次搜出出三个同样的结果,还不如在谷歌上site:layabox.com好使
3、API文档,能说说这TM是什么吗?乱哄哄一片,看了文档也不知道怎么用,还要去社区绕一圈看看有没有人遇到过
QQ20180120-161330.png

4、举个例子:用了你们好久竟然一直没找到碰撞系统,直到一个朋友发现你们竟然有碰撞系统。搜索都搜不到,文档还有什么用。
还有个例子,有个朋友入门你们教程,项目都快做完了,一直不知道还有IDE的设计模式,发现你们的IDE竟然是拖拖拽拽就能完成的,难道这不应该写在新手引导里面吗?
 
LAYA是个好东西,但是太多文档的坑,坑了好多人,所以换个产品经理吧.....
 
 
 

qian

赞同来自:

你可以具体说一下哪里的问题么~或者提一下你的建议也可以
我们会努力往好的地方去发展的

该问题目前已经被锁定, 无法添加新回复

商务合作
商务合作