[欢迎提交 PR 和 issue]Cocos Creator 新版用户手册上线!

感觉是这类 Vuepress、Docusaurus 框架自带搜索的通病,只要是这些框架做的文档网站,搜起来都不怎么得劲。

经过研究发现,VitePress 的中文搜索确实很弱,英文是非常OK的。
我们研究一下如何接入另一个中文搜索功能,谢谢反馈!

文档反馈打开eassing Api 404 404页面

新版的手册页面很好看,是动态页面,感觉是 Cocos 历史以来最好的一个版本,之前王楠用的 gitbook 最古老的版本,能撑到今天太不容易了。提个建议,引擎下载应该引导到 Cocos Creator 下载 - 轻量高效的开发引擎 页面。

文档真的很繁琐,要处理各种链接的转换、permanent link、404,搜索的权重要人工调优,要同时维护新老版本,现成的框架基本都要定制或者二开。看看 Creator 的 API 有多少个版本就知道了。最早 API 一样是 gitbook 用 markdown 转的,只能算是能用。

最恶心的应该是 3.0,当时用的第三方的,问题一大堆。到了 3.3 编辑器团队终于推翻重撸了一个版本,可以正常迭代维护了。

从 3.4 开始,Cocos 终于有了 PM 和设计师。把 API 文档从零设计了一次,细节都考虑到了,使用后端进行搜索,一直延用到今天。


顺便吐槽一下,当时有一个新来的前端,设计稿不还原就算了,功能做的像屎一样,细节没几个能看,浪费了我和设计师好多时间。后来我第一个就把他干掉了。

1赞

其他都好说,就是现在版本中文搜索很难用

没有产品走查,没有 QA 验收,研发能自驱捣鼓成这样很不容易了,你是没见过我吐槽的那个小哥做的东西。如果不能包容过错,那研发小哥干脆啥也别干躺平,反正多做多错,不做也不会少拿钱,公司也开不了,是吧。