
#107490 rustdoc: remove inconsistently-present sidebar tooltips
今天看到Rust源码仓库里这个PR在三天前被合并了,其内容是删除了Rust API文档边栏里的Tooltips显示功能,其理由是有别的地方没有Tooltips因而显得不协调(为何不再别处补上Tooltip)。他们在讨论时有两个人表示从来不知道有tooltip这个功能,这蛮出乎我的意料,鼠标移上去就有tooltip弹出来,为何感知不到。不过这至少说明对某些人而言Tooltip确实可有可无。
我觉得这个显示Tooltip的功能很好用,只需在边栏移动鼠标,就能很方便的看到各Item的主要功能介绍,节省了无目的点击连接跳转的操作。当需要浏览或模糊寻找某个Item,或需要按喜好挑选某个Item学习时,非常的有帮助。你需要它时它贴心的弹出来,不需要它时它静默不干扰任何人。被删除掉是比较可惜的。
这个功能的最初代码是我(Liigo)在8年前(2015年)编写提交的:
#20221 rustdoc: Add tooltips to sidebar (v3)
#23250 rustdoc: get back ‘plain summary line’ in sidebar
他们后来往边栏加入新的Item时(例如 #45187 加入methods)遗漏了Tooltip导致“不一致”,即有的地方有Tooltip,有的地方没有Tooltip。他们的解决方案不是补上没有的Tooltip,而是删掉已有的Tooltip。我不太赞同这种逻辑。

文章讨论了Rustdoc最近删除了API文档边栏中的Tooltips功能,这一改变源于一致性考虑,但有人认为这个功能实用并节省操作。作者Liigo是该功能的原始开发者,对于删除现有Tooltips而非补充缺失的表示不赞同。

被折叠的 条评论
为什么被折叠?



