Skip to content
  • Categories
  • Recent
  • Tags
  • Popular
  • Users
  • Groups
  • Search
  • Get Qt Extensions
  • Unsolved
Collapse
Brand Logo
  1. Home
  2. General talk
  3. Brainstorm
  4. Latest soapbox rant...quality of offline Qt documentation
Forum Updated to NodeBB v4.3 + New Features

Latest soapbox rant...quality of offline Qt documentation

Scheduled Pinned Locked Moved Unsolved Brainstorm
3 Posts 3 Posters 1.0k Views 3 Watching
  • Oldest to Newest
  • Newest to Oldest
  • Most Votes
Reply
  • Reply as topic
Log in to reply
This topic has been deleted. Only users with topic management privileges can see it.
  • Kent-DorfmanK Offline
    Kent-DorfmanK Offline
    Kent-Dorfman
    wrote on last edited by
    #1

    There are probably a couple of places where this post might fit, but this area is more likely to get folks attention.

    I really have to chastize the Qt folks for the lameness of the built offline documentation. Under the Trolltek regime it was really good: high contrast pages where things just popped out at the reader, appropriate use of side-panels, and a very comprehensive list of html docs to describe the framework in its entirety. Under the current Qt ownership the offline built documentation is drab, runs on with no visual queues to grab the reader's attention, and in many cases is either too vague, or refers to the cloud docs, even when when user expects to work offline.

    In many cases businesses distribute lame user docs by design. The less comprehensive and usable docs are, the more likely the customer is to pay for support or to buy training materials. Hmmm...makes me wonder...

    I have no interest in web design other than as a discerning user. When I initially load the main index.html, I briefly see the higher contrast, larger font information I expect, before the embedded style sheets detract from the experience. For the love of whomever you believe in....PLEASE BRING BACK HIGH CONTRAST FRAMES BASED DOCUMENTATION VIEWING WITH ADEQUATELY SIZED FONTS!!! The current default scheme is mind numbing.

    kshegunovK JKSHJ 2 Replies Last reply
    0
    • Kent-DorfmanK Kent-Dorfman

      There are probably a couple of places where this post might fit, but this area is more likely to get folks attention.

      I really have to chastize the Qt folks for the lameness of the built offline documentation. Under the Trolltek regime it was really good: high contrast pages where things just popped out at the reader, appropriate use of side-panels, and a very comprehensive list of html docs to describe the framework in its entirety. Under the current Qt ownership the offline built documentation is drab, runs on with no visual queues to grab the reader's attention, and in many cases is either too vague, or refers to the cloud docs, even when when user expects to work offline.

      In many cases businesses distribute lame user docs by design. The less comprehensive and usable docs are, the more likely the customer is to pay for support or to buy training materials. Hmmm...makes me wonder...

      I have no interest in web design other than as a discerning user. When I initially load the main index.html, I briefly see the higher contrast, larger font information I expect, before the embedded style sheets detract from the experience. For the love of whomever you believe in....PLEASE BRING BACK HIGH CONTRAST FRAMES BASED DOCUMENTATION VIEWING WITH ADEQUATELY SIZED FONTS!!! The current default scheme is mind numbing.

      kshegunovK Offline
      kshegunovK Offline
      kshegunov
      Moderators
      wrote on last edited by
      #2

      You're barking up the wrong tree, this is a user forum. Also I haven't seen any significant differences between the offline and online documentation, the fact that I use the online docs is only due to the fact that I don't want my docs to be in the same window as my code (what Creator does). Unless I misunderstood your box of soap I have no clue what you're talking about ...

      Read and abide by the Qt Code of Conduct

      1 Reply Last reply
      1
      • Kent-DorfmanK Kent-Dorfman

        There are probably a couple of places where this post might fit, but this area is more likely to get folks attention.

        I really have to chastize the Qt folks for the lameness of the built offline documentation. Under the Trolltek regime it was really good: high contrast pages where things just popped out at the reader, appropriate use of side-panels, and a very comprehensive list of html docs to describe the framework in its entirety. Under the current Qt ownership the offline built documentation is drab, runs on with no visual queues to grab the reader's attention, and in many cases is either too vague, or refers to the cloud docs, even when when user expects to work offline.

        In many cases businesses distribute lame user docs by design. The less comprehensive and usable docs are, the more likely the customer is to pay for support or to buy training materials. Hmmm...makes me wonder...

        I have no interest in web design other than as a discerning user. When I initially load the main index.html, I briefly see the higher contrast, larger font information I expect, before the embedded style sheets detract from the experience. For the love of whomever you believe in....PLEASE BRING BACK HIGH CONTRAST FRAMES BASED DOCUMENTATION VIEWING WITH ADEQUATELY SIZED FONTS!!! The current default scheme is mind numbing.

        JKSHJ Offline
        JKSHJ Offline
        JKSH
        Moderators
        wrote on last edited by
        #3

        @Kent-Dorfman Good timing. There is a 2-day intensive workshop this coming Monday for improving the docs: https://blog.qt.io/blog/2019/03/01/the-future-of-documentation/

        I encourage you to get in touch with Paul Wicking ASAP by posting in the blog comments, so that your complaints can be taken on board during the workshop.

        Qt Doc Search for browsers: forum.qt.io/topic/35616/web-browser-extension-for-improved-doc-searches

        1 Reply Last reply
        3

        • Login

        • Login or register to search.
        • First post
          Last post
        0
        • Categories
        • Recent
        • Tags
        • Popular
        • Users
        • Groups
        • Search
        • Get Qt Extensions
        • Unsolved