Qt World Summit 2023: Berlin awaits! Join us now
最新版Qt 6.3已正式发布。 了解更多。
最新バージョンQt6.5がご利用いただけます。 詳細はこちら

Doc facelift II – The community has spoken.

The response on my first blog post about the documentation facelift was so huge that for a moment I was wondering of what I had gotten myself into.:) A response like this would for sure set the level of expectations sky high and be giving our team a lot of work to be able to meet our users’ wishes. Yet again, that is what design is all about – meeting the needs and demands of the people using the product. Moreover, getting a response and engagement like this is more than a designer could ever wish for. It shows that our users care about the documentation, and that is very inspiring.

Now, with this in mind we continued the work by creating a user test that we ran at Qt Developer Days in Munich a few weeks back. If the response on the blog post was huge, the amount of people doing the test was even larger. Close to 15 % of the Developer Days attendees did the survey, and we got lots and lots of good feedback. I want to take this opportunity to thank all those who participated. All together you spent close to twelve hours giving us valuable information for our design process. That is amazing! :)

We now have good numbers on which solutions you want, and even better numbers on what you do not want. In addition to the poles, we got many constructive comments, which have been very useful in the process so far. To a large degree, the feedback from the test reflects the results from the feedback on the first blog post. Therefore, without dragging things out further I will tell you about the results from the test.

Design profile
In the test the users were told to choose from a set of different design concepts. The first three concepts were quite similar to the current design, displaying a set of categorized link menus. The design that got the most votes was the one using colors, icons and visual structures like borders and bullet points. This was not really a surprise since the blog feedback gave us the same indications. What did surprise me though, was that you didn’t want search results from the Google custom search engine embedded in the documentation pages. That is a clear indication of the value of user testing. :)

Full front page design

However, to sum it up, the design and feature profile you want us to use is:

  • A front page similar to the current one, only using more colors and some discrete icons for recognition.
  • A search box, preferably with automatic suggestions for keywords as you type. Ajax search design example
  • A line of bread crumb links in the top area of the page, visualizing the page hierarchy and enabling the user to “jump” to pages several levels up. Bread crumbs design example
  • A left-side menu on sub-level pages (like the class pages), ordered in a hierarchical way. Menu design example
  • A way to hide and show detailed information. Show/hide design example
  • A history box displaying resent searches.

You have also said that you learn best from reading and testing examples and how-tos’. We have a great collection of examples already, but we could also create more of them.

Your list of wishes
As we now draw nearer to Christmas, the concept of wish lists should be familiar to most of us. We send of our list to Santa Claus – or tell our beloved ones what we wish for – and then hope for the best. Sometimes we get what we wish for, and sometimes not. My point is this; the list of wishes will be our guide on the way to what I hope will be a good design, but it will not be a guarantee to make your every wish come true.

Our goal is still to create a design meeting the needs of both the experienced and new Qt users. We need better navigation, better ways to categorize overviews and to improve searches. In other words, we have a lot of work in the months to come. We need to further analyze the design and find out how we best could implement the new solutions. There will be some short-term goals and some long-term goals. I will blog more about them as soon as they are implemented. I still urge you to keep the feedback coming in. It is useful for us and very inspiring.

Blog Topics: