Details
-
User Story
-
Resolution: Done
-
P1: Critical
-
None
-
None
-
None
-
Qt Quick 3D - wk 45/46
Description
The documentation for the Qt Quick 3D module needs to be in a complete state for release along with Qt 5.14 as a tech preview so that users are able to actually to use this new module and give feedback.
Getting the documentation into a releasable state should also enable us to confidently require documentation for any new features being added as a requirement for that feature being "Done".
This task consists of many sub-tasks for each part of the public API and examples (there is a second task for the examples themselves, but this task covers the documentation of all examples present currently).
All public APIs should be be fully documented. That means descriptions of what the class is used for, and each property/method, as well as helpful code snippets where appropriate as well as references to usages in example code.
In addition there should be an overview page describing the module as whole, and how to use it.
Also we need to make sure that the documentation is accessable from the global Qt Docs infrastructure (for example qtmodules.html)
For reference here are the guidelines for writing Qt documentation:
https://wiki.qt.io/Qt_Writing_Guidelines
Attachments
Gerrit Reviews
For Gerrit Dashboard: QTBUG-79360 | ||||||
---|---|---|---|---|---|---|
# | Subject | Branch | Project | Status | CR | V |
80757,1 | Doc: Added info on Qt WebSockets module | stable | qt/qtdoc | Status: MERGED | +2 | 0 |
279367,2 | Add linking to QtQuick3D TP module | 5.14 | qt/qtdoc | Status: MERGED | +2 | 0 |
279399,4 | Finalize light api documentation | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
279587,10 | Document material library assets | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
280176,4 | Document missing property of View3D | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
280208,2 | Fix see also links in Camera | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
280214,4 | Add docs for Helpers | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
280249,3 | Fix see also usage in the Material documentation | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
280255,2 | Fix see also in Node | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
280348,2 | Fix links in SceneEnvironment | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
280351,2 | Fix links in Texture | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
280382,5 | Document RenderStats properties | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
280386,3 | Fix View3D documentation | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
280448,5 | Update documentation for the principled material | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
280510,5 | Document QQuick3DPickResult | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
280675,7 | Improve the documentation for the model | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
280710,2 | Fix PickResult documentation warnings | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
280731,11 | Document custom material and friends | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
281110,2 | Finalize Node documentation | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
281422,10 | Doc: Update module overview page | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
281573,6 | Doc: Balsam Asset Import Tool | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
281586,6 | Add documentation for OpenGL requirements and considerations | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |
281661,8 | Add asset conditioning docs | 5.14 | qt/qtquick3d | Status: MERGED | +2 | 0 |