Skip to main content

文档 UI 问题之 Flask

之前讨论过 Python 文档的一个 UI 问题。最近发现 Flask 文档也有类似的问题,但表现形式不大一样。

上面的链接会自动跳转至最新的稳定版本(目前是 2.3.x)的文档。其网站由 Read the Docs 驱动,通过右下角的菜单可切换版本。其中,latest 是开发版本的文档。页面的顶端会显示:

Warning: This is the development version. The latest stable version is Version 2.3.x.

这自然是很友好的提醒。若将版本切换至 2.2.x,也会看到类似的提示:

Warning: This is an old version. The latest stable version is Version 2.3.x.

可是,当查看 2.1.x 版本的文档时,提示的内容却是:

Warning: This is an old version. The latest stable version is Version 2.2.x.

同样,2.0.x 版本的文档里写着:

Warning: This is an old version. The latest stable version is Version 2.1.x.

此类提示语虽因版本而异,却不应为版本机制所管理。它应与右下角的菜单处于同一逻辑层次。Flask 与 Python 的文档 UI 都出现了版本机制越俎代庖的失误。