征集 Creator 3.x 官方文档内容的修改建议

亲爱的小伙伴们,Creator 为了更好地贴近用户需求,现新开了一个 文档反馈 的版块,用于征集文档修改建议,后续会根据收集的意见来调整文档结构及内容,让文档更加全面,确保质量和体验,欢迎大家反馈。

可以反馈的点:

  • 内容缺失,需要增加哪方面的文档
  • 整体结构问题,如大纲安排、篇幅问题、学习曲线……
  • 内容上的 bug,如错别字、歧义、链接无法跳转、排版问题、中英文用词不当……
  • 描述上的问题……
    ……

发帖时请尽量说清楚问题在哪,最好能 标注版本附上链接,以及 改进建议
感谢大家,限于人力和时间可能无法一一回复,但是我们一定会虚心听取你们的意见。

当然,我们也非常欢迎小伙伴们主动向我们提交 PR,帮助文档越来越好:

另外,为了节约大家时间,请不要在这里回复和本论坛板块无关的话题,所有文档问题请在此板块单独发帖讨论。

API文档搜索功能经常要么搜不到,要么搜出来不是要找的;2.x版本的好用。

2赞

先修复下搜索框 字打快了很卡

1赞

第一优先建议:
给出现成的各类粒子特效模板实现
给出各式奇奇怪怪的Shader实现

后续建议(可能和上面重复):

  • 建议添加自定义Mesh的原理和例子资料
  • 建议给出Shader的那个 USE_TEXTURE、ALPHA_TEST 宏,CCTexture 函数 的实现过程原理(好像你们鸡贼,源码、实现给藏起来了)。以及绑定 gfx.那一堆 attr, uniform的引擎实现过程的引导讲解。这个比较复杂,但是这个也必然是大团队敢上马大项目的一个重要因素,老板不懂,主力程序领薪脱产基本一个月能搞懂大部分,业余时间三到六个月也能搞懂大部分,就是差了这份入门领路文档,如果主力程序有底气了,就会去忽悠老板入坑。
  • 建议添加WebGL知识铺垫,尤其深度缓冲,光栅原理,以及高端一点的自实行ShaderMap的原理,半透明和全不透明的混合渲染流程
  • 建议添加自定义Shader去描边,消融,色相,黑白,勾出轮廓等等高端用法。
  • 建议添加矩阵数学、四元数相关的资料。
  • 建议给出全屏截图、区域截图、按二维节点范围截图的完整示例(别弄到例子工程中,弄到文档里)
  • 建议给出建议的成熟的2D换装、动作工作流。
  • 建议给出建议的成熟的3D动作生产、3D换装的全流程工作流,本来好多2D的玩家,转3D好多会长期停留在AssetsStore拉点东西回来组装一下的程度,引擎规划这么高大上,就怕用户水平差了,可能会出现UE用户弄出比Unity 5.x还差效果的情况。

总之一句话,努力实现一站式资料大全。

既然花这么大力气了,不妨写出自己的特色。

根据外挂行业经验,易语言是广泛度第一语言地位(不是指深度)。

所以不要小瞧群众,可能是你们没有给群众创造出输出环境。

也许Creator3D引擎是未来10年最成功的的引擎,如果具备如下条件:先进的技术引擎团队(已经具备),以及先进的营业方式(已经具备),广泛的群众基础(就差这了)。

1赞

我是新手··官方说明文档和使用界面出现出入···右键创建 JS,在说明文档中包含三个 JS,TS … 在3.20里只有TS

感谢反馈,API 文档近期已经开始安排专人着手开始改造了哈,可能没那么快完成,但会一直跟进的。

非常感谢建议,很棒的建议,我们之后的文档结构和内容会采取相应的意见进行优化,但文档是一个长期的任务,任重道远,请给我们一点时间,也欢迎继续反馈哦~

请问你使用的是哪个版本的文档,以及哪一篇文档呢?我在 3.0 版本的脚本创建中看了一下是已经更新了的:https://docs.cocos.com/creator/3.0/manual/zh/scripting/setup.html

这些不能怪引擎,
只要OpenGL基础学得好,
引擎怎么变都无所谓,使用无障碍。
核心基础东西一直没变,
从1.x到3.x我们定制修改没停过,
唯一希望就是api接口设计得稳一点!

大哥说的也有道理,我举得的是另外一种思路,就是军官不是军校出来的,是打仗出来的。

你说的是找军校出来的高材生再去领兵打仗,我说的是打仗的人中有天赋的人再去给予引导当军官。各有优势。

如果文档能增加图形等方面的基础知识是不是会更好, 这样会有更多人愿意花时间看文档学习,也能吸引更多新手

3D这块除非是有其他引擎的3D经验如unity3D这样的,不然很多都不懂,连最基本是旋转用四元数都用不清楚,我今天还在纠结为什么旋转之后cube的形状变了,奇奇怪怪的,还在学,如果官方能出一些3D方面的教程或者DEMO就好了

这块我们后面会在文档里补充一些代码示例,官方的范例 demo 在文档首页就有的:https://docs.cocos.com/creator/3.0/manual/zh/#演示和范例项目

api的文档特别特别特别的卡!!!!! 搜索栏打字都卡真的受不了 巨难受 打字掉帧的感觉

1赞

请问为什么没有 particle system 2d 的介绍,是要我们翻2.4的文档么?

目前确实挺不好用的,近期已经开始安排专人着手开始改造 API 文档了哈,可能没那么快完成,但会一直跟进的!

这块确实漏了,不好意思哈,麻烦先参考一下 2D 的了,我们尽快这星期补上!

参考 小游戏分包
分包已经做了,但是文档中没说明,如何验证是否成功。
经过反复试验,发现 分包这部分的文档 没有说明要在构建项目的时候选择 主包压缩类型为小游戏分包
image

@edgexie 有的呀,在你发的链接,小游戏分包的配置方法这里有写:

验证是否成功在 构建 部分也有说明呀: