[Development] Documentation todo for Qt 5.2

Pasion Jerome Jerome.Pasion at digia.com
Fri Sep 27 13:33:07 CEST 2013


Hello all,

Moving forward, this is a sanity check list related to documentation.
I would like to get people to start looking at their content for missing documentation sooner than later.

(I'm linking to the documentation from stable, but these should apply to all Qt 5 branches)

Mainly:
- New modules should be listed as either an "Essential" or an "Add-On": http://doc-snapshot.qt-project.org/qt5-stable/qtmodules.html
-Classes should be in the "All Classes" page: http://doc-snapshot.qt-project.org/qt5-stable/classes.html
-QML types should be in the "All QML Types" page: http://doc-snapshot.qt-project.org/qt5-stable/qmltypes.html
-pages should be accessible from the main page through the "Overviews", "Reference", and "Getting Started" sections. (Don't bury the pages so nobody can find them).
-wiki material (which is convenient during the planning and development phases) should be ported over to the Qt reference so they get packaged with the installers.
-the same requirements for every module still apply: landing page, C++ classes page, QML types page, examples, and overview. The requirements are in the Qt Writing Guidelines wiki.

These points are also  in the Qt Writing Guidelines: http://qt-project.org/wiki/QtWritingGuidelines including a checklist for adding documentation to a new module.
We also have an umbrella bug report covering Qt 5.2 documentation issues: https://bugreports.qt-project.org/browse/QTBUG-32173
As always, feel free to ask questions or if your project has an exotic setup that we should know about.

Cheers,
Jerome P.
Documentation Engineer - Digia, Qt
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.qt-project.org/pipermail/development/attachments/20130927/2ff48eca/attachment.html>


More information about the Development mailing list