diff options
author | Chris Adams <christopher.adams@nokia.com> | 2012-07-31 16:28:59 +1000 |
---|---|---|
committer | Qt by Nokia <qt-info@nokia.com> | 2012-08-02 03:17:02 +0200 |
commit | 5a96befcdeaf822e503a8e27bf33668099f9f185 (patch) | |
tree | 73fa0bd9db1835d9320a098103fb8fbda32825df /src | |
parent | 2fe0f03d4d99dd3cee8a47d6e27db3d40f452825 (diff) |
Minor restructuring of application developer resources
Move the QtQml/QtQuick overviews below the quickstart / usecases
sections. Merge the Important Topics and Debugging And Testing
sections into a single Advanced Topics section. Modify some of the
formatting used to improve the consistency of the page.
Change-Id: Iab0b077130a763951a2967e725c2ef8ec2937ae8
Reviewed-by: Bea Lam <bea.lam@nokia.com>
Diffstat (limited to 'src')
-rw-r--r-- | src/quick/doc/src/appdevguide/applicationdevelopers.qdoc | 90 |
1 files changed, 56 insertions, 34 deletions
diff --git a/src/quick/doc/src/appdevguide/applicationdevelopers.qdoc b/src/quick/doc/src/appdevguide/applicationdevelopers.qdoc index 709e2cd5a7..f72f129894 100644 --- a/src/quick/doc/src/appdevguide/applicationdevelopers.qdoc +++ b/src/quick/doc/src/appdevguide/applicationdevelopers.qdoc @@ -53,37 +53,34 @@ See QTBUG-26428 */ +/* +XXX + +The "QML Intro" section has been temporarily removed, as it includes mostly +outdated information. However, it has some pertinent information, so we +should review it and extract the useful documentation at some point, for +inclusion somewhere in the documentation. In particular, the documentation +related to using QtCreator for QML development seems useful. + +\li \l{qml-intro.html}{Introduction to QML Application Development} +*/ + /*! \page qtquick-applicationdevelopers.html \title QML Application Developer Resources \brief Essential documentation for QML application developers -\section1 Overview of QML and Qt Quick - -\section2 What is QML? - -QML is a user-interface specification and programming language. -It allows highly performant, fluidly animated, visually appealing applications -to be rapidly developed by either developers or designers. QML offers a -highly-readable, declarative, JSON-like syntax with support for imperative -JavaScript expressions combined with dynamic property bindings. +QML is a declarative language that allows user interfaces to be described in +terms of their visual components and how they interact and relate with one +another. It is a highly readable language that was designed to enable +components to be interconnected in a dynamic manner, and it allows components +to be easily reused and customized within a user interface. Using the +\c QtQuick module, designers and developers can easily build fluid animated +user interfaces in QML, and have the option of connecting these user +interfaces to any back-end C++ libraries. -\b {The QML language and engine infrastructure is provided by the Qt QML module. -See the \l{qtqml-main.html}{Qt QML Module Documentation} for -in-depth information about using the QML language.} - - -\section2 What is Qt Quick? - -Qt Quick is the standard library of types and functionality for QML. It -includes visual elements, interactive elements, animations, models and views, -particle effects and shader effects. A QML application developer can get -access to all of that functionality with a single import statement. - -\b {The QtQuick QML library is provided by the Qt Quick module. See the -documentation for the \l{qtquick-main.html}{Qt Quick Module Documentation} for in-depth -information about the various QML types and other functionality provided by -Qt Quick.} +This page links to all the information you need to start developing +applications with QML and QtQuick. \section1 Quick Start @@ -102,23 +99,48 @@ Qt Quick.} \endlist \endlist -\section1 Important Application Development Topics +\section1 In-Depth Documentation + +\section2 What is QML? + +QML is a user interface specification and programming language. +It allows developers and designers alike to create highly performant, fluidly +animated and visually appealing applications. QML offers a highly readable, +declarative, JSON-like syntax with support for imperative JavaScript +expressions combined with dynamic property bindings. + +The QML language and engine infrastructure is provided by the Qt QML module. +For in-depth information about the QML language, please see the +\l{qtqml-main.html}{Qt QML Module Documentation}. + +\section2 What is Qt Quick? + +Qt Quick is the standard library of types and functionality for QML. It +includes visual elements, interactive elements, animations, models and views, +particle effects and shader effects. A QML application developer can get +access to all of that functionality with a single import statement. + +The QtQuick QML library is provided by the Qt Quick module. +For in-depth information about the various QML types and other functionality +provided by Qt Quick, please see the \l{qtquick-main.html} +{Qt Quick Module Documentation}. + +\section1 Advanced Application Development Topics \list -\li \l{qml-intro.html}{Introduction to QML Application Development} \li \l{qtquick-performance.html}{Performance Considerations and Suggestions} \li \l{qtquick-internationalization.html}{Internationalization and Localization} +\li Testing and Debugging + \list + \li \l{qtquick-qmlscene.html}{Prototyping with qmlscene} + \li \l{qtquick-debugging.html}{Debugging QML Applications} + \li \l{qtquick-qtquicktest.html}{QtQuickTest: QML Unit Testing Framework} + \endlist \li \l{qtquick-glossary.html}{Glossary of Terms} \endlist -\section1 Testing and Debugging -\list -\li \l{qtquick-qmlscene.html}{Prototyping with qmlscene} -\li \l{qtquick-debugging.html}{Debugging QML Applications} -\li \l{qtquick-qtquicktest.html}{QtQuickTest: QML Unit Testing Framework} -\endlist - \section1 Release Notes and Porting Guides + \list \li \l{qtqml-releasenotes.html}{QtQml Module Release Notes} \li \l{qtquick-releasenotes.html}{QtQuick Module Release Notes} |