Uploaded image for project: 'Qt'
  1. Qt
  2. QTBUG-104500

Convert overview "\page"s that are intended to be available under "groups.html" to "\group"

    XMLWordPrintable

Details

    • Task
    • Resolution: Fixed
    • P3: Somewhat important
    • None
    • None
    • Core: Other, Documentation
    • None
    • Foundations Sprint 80, Foundation Sprint 81, Foundation Sprint 82

    Description

      QDoc allows the grouping of semantically related elements under a "group", through the "\ingroup" command.

      A page documenting the meaning of a group can be produced through the "\group" command, further containing a reference to each element associated with it.

      One particular group that is used in our documentation is the "groups" group. The "groups" group is a group that references other group pages in our documentation in order to provide an entry-point to many of our overview documentation pages.

      Currently, due to the recent changes in QTBUG-104238, each class/qmltype page now references the group pages that it is related to, such as to provide greater discoverability for them.

      Currently, the "groups" group does not only contain group pages. Indeed some actual "\page"s are element of this group.

      With the recent changes, this now means that there is a path, from the page of the "groups" group, that will bring the user to some class/qmltype pages that provides no link back to the page that the user comes from, contrary to what the user might experience with other pages under "groups", providing for a confusing experience.

      For example, Container Classes is such a page.

      To avoid this confusion, those "\pages" could be converted to "\group" pages. This should be possible without having to change the page itself, albeit some restructuring may be propedeutic to the change if only to account for the list of item that will be introduced in the page.

      Attachments

        Issue Links

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

          Activity

            People

              javyas Jaishree Vyas
              diseraluca Luca Di Sera
              Vladimir Minenko Vladimir Minenko
              Alex Blasche Alex Blasche
              Votes:
              0 Vote for this issue
              Watchers:
              1 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved:

                Gerrit Reviews

                  There is 1 open Gerrit change