HarmonyOS 鸿蒙Next版本官方文档不利于查找,不论是API还是指南

发布于 1周前 作者 sinazl 来自 鸿蒙OS

HarmonyOS 鸿蒙Next版本官方文档不利于查找,不论是API还是指南

如题。

以前版本文档截图:

cke_413.png

next文档截图:

cke_2298.png

找一个应用权限控制文档,翻了半天没找到,还要搜索才出来。next是显得高级些了,然后呢?花更多时间去找文档?直接点好吧,文档可以快速找到想要的内容,才符合开发者的第一需求。

要不是3.0官方文档版本内容没更新,真不想来翻next版本。目录中,一堆字母在前面,感觉就像是外国人弄的,如果是给外国人看的,倒是无所谓。中文版的还是直接用中文吧,我相信,但凡是土生土长的中国人,没谁会觉得英文比中文更容易理解。

没有批评谁,也没有针对谁,对于我这种喜欢看中文的来说,只是觉得文档现在找资料没有以前直观。

22 回复

开发者您好,感谢您的反馈~

当前HarmonyOS NEXT文档的导航在考虑了开发者对模块使用诉求的基础上,在现有Kit维度上增加了分类。

少量特性,如程序访问控制,可能与开发者对印象中的分类位置不一致,我们当前在讨论对类似内容的划分逻辑。

欢迎您反馈更多建议,如果您愿意可以留下邮箱,我们联系您进一步探讨。

感谢~

谢谢邀请,很乐意参与文档的优化。邮箱745794335@qq.com

HarmonyOS的分布式文件系统让我在多设备间传输文件变得轻松无比。

如何看老的api文档?

开发者您好,可以通过官网右侧,文档 入口,进入后,选择不同的版本页签进入

有要学HarmonyOS AI的同学吗,联系我:https://www.itying.com/goods-1206.html

请教个问题?

编译 Android 抛异常:

First attempt: load module failed. dlopen failed: library "libshared_libz.so" not found:
Second attempt: load module failed. dlopen failed: library "/data/user/0/com.example.myharmonytest/files/arkui-x/libs/arm64-v8a/libnet_http.so" not found

跳转网络请求的页面,Android Studio 就抛这个异常?为什么,怎样解决?

这个问题超出我的知识范围了,可以直接去论坛发个问题求助贴,或许会有答案

您好,该问题已经反馈过官方,官方会成立专门的文档维护团队,下半年会有改善

了解,谢谢

这个文档结构确实得重构下,我觉API参考至少得在指南里给个入口,否则每次在指南里看完介绍和demo,要看参数列表,都要手动点击上面的API参考,而且还不是直接跳转到我之前正在看的那个组件的参考,而是在最顶层,想要找到刚才查看的那个组件或者类,还得手动展开左侧的目录去找。这个操作很耗时

对的,就是被这种情况烦到了

开发者您好,当前官网在指南和API参考切换时,有考虑到开发者使用上停留在上一次的参考页面,所以没有直接从某个指南kit跳转API kit。 这个体验大家希望停留在上一次的页面,还是直接映射当前使用的KIT内容对应API?

打开一个新的标签,然后自定定位到所对应的api参考,我觉得这样符合我自己的使用习惯,其他开发者的习惯是怎样的我就不清楚了

试下 CodeGenie 这个插件 华为的  类似gpt 

谢谢,多谢分享

建议加个搜索内容关键字搜索栏就好了

目录顶端有这个搜索栏,但是很多时候搜索的方式没有根据目录查找方便。例如:我学习的时候,记忆内容分类就是按照目录来记的,这样我就知道我要的内容在哪一个目录,这样可以出来一堆及相关内容,但是搜索只能针对输入的关键字

HarmonyOS 鸿蒙Next版本官方文档的查找问题确实可能对开发者造成一定困扰,这通常源于文档结构的复杂性或搜索功能的局限性。针对这一问题,以下是一些可能的解决方案:

  1. 文档分类与索引:首先,建议仔细研究HarmonyOS的官方文档分类,确保你正在查找的API或指南位于正确的目录下。利用文档中的索引功能,可以更快地定位到所需内容。

  2. 搜索优化:使用精确的关键词进行搜索,避免使用过于宽泛或模糊的词汇。同时,可以尝试不同的搜索组合,以获得更全面的结果。

  3. 版本匹配:确保你正在查看的是与HarmonyOS鸿蒙Next版本相匹配的文档。不同版本的文档可能存在差异,因此版本匹配至关重要。

  4. 官方社区与论坛:参与HarmonyOS的官方社区和论坛,与其他开发者交流心得。他们可能遇到过类似的问题,并能提供实用的解决方案。

  5. 技术文档培训:如果可能,参加HarmonyOS提供的技术文档培训课程。这些课程通常能更深入地介绍文档的组织结构和查找技巧。

如果问题依旧没法解决请联系官网客服,官网地址是:https://www.itying.com/category-93-b0.html。希望以上信息能对你有所帮助。

回到顶部