Qt 5 Example Clean-up Project

From Qt Wiki
Jump to navigation Jump to search

We are working on cleaning up the set of examples in Qt. Qt now has ~445 examples, and this is just way more than needed.

Goal

The goal for this clean-up project is to:

  • make it easier for anyone to find a useful example that serves a given purpose.
  • make the set of examples easier to maintain
  • make sure we can be proud of all examples

What are examples used for

Examples serve different purposes. These can be:

  • Snippet: What a developer finds useful to look at to find out how do use/understand an API
  • Example: To show off how a given class, element, or other works
  • Demo: What you would like to run to show off Qt's capabilities when wanting to convince someone that Qt is the right choice.
  • Tutorial: A step-by-step how-to with belonging examples that teach how to implement given functionality.
  • Test: Stand-alone app that is useful to run to test whether a given class/component/.. still works as intended

Quality criteria for an example

  • Does it have a meaningful purpose? Or is the feature it demonstrate deprecated or obsolete in Qt 5?
  • Does it follow Qt 5 "best practice" / recommended way of doing things?
  • Are the comments, text strings README, etc. up to date? E.g., not mentioning Qt4 or Nokia, not unnecessarily widget- or phone-centric.
  • Is the example documentation, i.e. the corresponding .qdoc file, if any, up to date?
  • Does the structure follow the example shown in the documentation structure overview?

(See also guidelines on how to write examples and their documentation.)

How to get there

  1. For each example: run it, mark it to belong to one or more of the above mentioned categories, and provide comments on how it works, if it looks good or ugly or something in between - i.e. would you be proud to show it off. Participate by going through some of the examples, and add your comments: List of examples in Qt 5
  2. Once the above is done, we will hopefully know how to structure the examples better, and also which ones to delete.
  3. Make a demo app that is a collection of all the cool demos we have + more