Details
-
Improvement
-
Resolution: Won't Do
-
Not Evaluated
-
None
-
None
-
None
Description
If I visit any of the online Qt5 documentation pages at doc.qt.io, a banner is shown asking whether I'd like to see the Qt6 docs instead:
But if I were to click that "here" link in the banner, I would be taken to https://doc.qt.io/qt-6/, completely losing my place in the docs.
Why? For most of the documentation, a given page at the Qt5 docs:
https://doc.qt.io/qt-5/qinputmethod.html
will have a corresponding page at the Qt6 docs:
https://doc.qt.io/qt-6/qinputmethod.html
The banner link could easily perform that substitution and attempt to deliver me to the Qt6 version of the same doc I was just reading for Qt5.
Sure, occasionally there isn't a corresponding Qt6 doc, because something like https://doc.qt.io/qt-5/qglwidget.html has no Qt6 equivalent, but those cases are fortunately more rare than not.
And, yes, the 404 page could probably be enhanced a bit so that visiting https://doc.qt.io/qt-6/qglwidget.html doesn't feel like such a dead-end (maybe it even makes sense to just redirect right back to https://doc.qt.io/qt-6/ instead of even showing as 404 page, in those cases.)
But it still feels almost... rude, when the site directs someone away from an outdated version of the documentation they actually want to read, offers them more up-to-date information, and then unceremoniously dumps them at https://doc.qt.io/qt-6/ instead of where they want to be.