Uploaded image for project: 'Qt Project Website'
  1. Qt Project Website
  2. QTWEBSITE-1038

The Qt5 -> Qt6 banner link on the docs site should try to preserve context



    • Improvement
    • Resolution: Won't Do
    • Not Evaluated
    • None
    • None
    • doc.qt.io
    • None
    • All


      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:


      will have a corresponding page at the Qt6 docs:


      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.


        No reviews matched the request. Check your Options in the drop-down menu of this sections header.



            treinio Topi Reiniö
            ferdnyc Frank Dana
            0 Vote for this issue
            2 Start watching this issue



              Gerrit Reviews

                There are no open Gerrit changes