ChaiByte
ChaiByte
近期在 [rCore-Tutorial-Book-v3](https://github.com/rcore-os/rCore-Tutorial-Book-v3) 的知识海洋中徜徉,收获颇丰。感谢各位作者的辛勤付出,目前就阅读体验而言给出几点建议: 1. 目前 utterance 评论一旦内容过多,则在相应章节所占页面高度比例超过 1/3 ,已经对阅读体验有所影响,尽管在侧边栏 Sidebar 中已经提供了 TOC, 但该部件在 iPad 等平板阅读设备中是隐藏的,想要翻页则不得不下滑到页面底部或者打开左侧的导航栏,体验并不是很流畅。目前想到的可能的改进思路是使用带 Collapse 或 Dropdown 功能的 Sphinx 样式插件(如 Sphinx Design / Sphinx Collapse),或使用原始的 HTML 语法,默认将评论区隐藏。 2. GitHub...
我注意到近期几个版本的文档更新在文档版本切换时将细粒度进行了提升,由 ```shell "." " # 1.13 ``` 变为了: ```shell "." "." " # 1.13.1 ``` 该做法在文档页面中并不常见,好奇这是出于何种考究?通常如果采取此做法,则建议在小的 patch 版本停止更新后,将默认的 minor 版本展示为对应的最新版,参考 [pandas](https://pandas.pydata.org/docs/index.html) 实现。例如:如果 1.12.4 是 1.12 的最后一个版本,那么在 [JSON](https://www.megengine.org.cn/doc/version.json) 格式的配置文件中,应当只保留 1.12 并指向...