关于优化社区文档的阅读体验,欢迎您的反馈:

https://gitee.com/openeuler/website/issues/I1E208?from=project-issue

issue内容如下:

关于文档阅读体验,有如下issue反馈:
1、https://gitee.com/openeuler/docs/issues/I1CTZ8?from=project-issue
2、https://gitee.com/openeuler/docs/issues/I1CPWY?from=project-issue
3、https://gitee.com/openeuler/docs/issues/I1CPXV?from=project-issue
主要问题点在于:
1、目录结构不易展开
2、文档内容不连续,层级太多且无法顺畅翻页阅读。每次都需要在左侧导航切换
希望提供pdf、single page、multi page不同阅读体验
sigle page:一个页面显示一个章节的所有内容,且能够提供页内的索引、目录或者浮动目录
multi page:一个页面内显示一个手册的所有内容。
针对这些问题,请大家体验下mindspore资料阅读方式,如果大家认可该方式,openEuler社区文档就按照该框架优化资料阅读内容:
https://www.mindspore.cn/tutorial/zh-CN/master/index.html

您是否认可mindspore的阅读体验?或者有更好的建议参考?

【English】

The following issues have been reported regarding document reading experience:
1.https://gitee.com/openeuler/docs/issues/I1CTZ8?from=project-issue
2.https://gitee.com/openeuler/docs/issues/I1CPWY?from=project-issue
3.https://gitee.com/openeuler/docs/issues/I1CPXV?from=project-issue
The main problems are as follows:
1.The directory structure is difficult to expand.
2.The document content is not continuous. There are too many layers and pages cannot be turned smoothly. You need to switch between the navigation tree on the left each time. Different reading experience for PDF, single page, and multi page.
sigle page: All contents of a chapter are displayed on a page. In addition, indexes, directories, or floating directories can be provided on the page.
multi page: displays all contents of a manual on a page.

To solve these problems, please experience the MindSpore documentation reading mode. If you agree with this mode or have made improvements based on this mode, the documentation of the OpenEuler community will be optimized based on this mode. **https://www.mindspore.cn/tutorial/zh-CN/master/index.html **

Do you recognize mindspore's reading experience? Or do you have any better suggestions?