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

    XMLWordPrintable

Details

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

    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.

      Attachments

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

        Activity

          People

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

            Dates

              Created:
              Updated:
              Resolved:

              Gerrit Reviews

                There are no open Gerrit changes