doc: Add a better structure to the landing page

The landing page first explains what QtIvi is and dives more into the
core part and the tooling side. The reference API is now the second
part and is clearly stated as a reference API.

Change-Id: I23bf3b2d041bee9fcc58fc576293ae57f812294a
Reviewed-by: Antti Hölttä <ahoelttae@luxoft.com>

2 files changed, 28 insertions, 13 deletions

diff --git a/src/ivicore/doc/src/ivigenerator/getting-started.qdoc b/src/ivicore/doc/src/ivigenerator/getting-started.qdoc
index 0249f2c..eed6cb2 100644
--- a/src/ivicore/doc/src/ivigenerator/getting-started.qdoc
+++ b/src/ivicore/doc/src/ivigenerator/getting-started.qdoc
@@ -65,6 +65,8 @@ The actual implementation of the class behavior is done inside a \e backend plug
 backend plugin can be generated by using the \l {backend-simulator-template}{backend_simulator} template. For more information
 how Qt locates and loads its plugins, please see \l {How to Create Qt Plugins} {here}.
 
+\section1 In Depth Walkthrough
+
 For more in-depth information, the \l {Qt IVI Generator Example} comes with a step by step documentation.
 */
 
diff --git a/src/ivicore/doc/src/qtivi.qdoc b/src/ivicore/doc/src/qtivi.qdoc
index e399cdd..29f19e0 100644
--- a/src/ivicore/doc/src/qtivi.qdoc
+++ b/src/ivicore/doc/src/qtivi.qdoc
@@ -29,14 +29,15 @@
     \title Qt IVI
     \keyword QtIvi
 
-    The Qt IVI (In-Vehicle Infotainment) module provides C++ classes and QML types
-    for accessing vehicle features, as well as a core API for implementing
-    new IVI features manually or using a \l {The Qt IVI Autogenerator}{auto generator}.
+    The Qt IVI (In-Vehicle Infotainment) module provides tooling and core classes for implementing
+    interfaces to middleware services. \l {The Qt IVI Autogenerator} provides a flexible way to
+    define new APIs in an IDL (interface definition language) and generate classes usable from
+    C++ as well as from QML.
 
-    The module is built around a pattern based on the separation of API facing the
-    application developer, the so called \e {Feature}, and the code implementing it,
-    the \e {Backend}. There can be multiple backends per feature and the Core module
-    provides support for finding the corresponding backend in an easy-to-use way.
+    The module is built around a pattern based on the separation of API facing the application
+    developer, the so called \e {Feature}, and the code implementing it, the \e {Backend}. There
+    can be multiple backends per feature and the Core module provides support for finding the
+    corresponding backend in an easy-to-use way.
 
     Common use cases driving this separation are:
 
@@ -51,24 +52,36 @@
         meaning that backends come and go over time.
     \endlist
 
-    The module provides an extendable set of reference APIs for automotive
-    features. It can be used to develop automotive applications and to provide
-    automotive features to Qt-based applications in a structured manner.
-
     \section1 Important Topics
 
     \list
     \li \l{Configuration}
     \li \l{Concepts}
-    \li \l{Using the Qt IVI Reference API}
     \li \l{Extending Qt IVI}
-    \li \l{QtIvi Backends}{Available Backends}
     \endlist
 
     \section1 Getting Started
 
     \list
       \li \l {Getting Started Using the Qt IVI Generator}
+    \endlist
+
+    \section1 Reference API
+
+    In addition to the tooling an core APIs, the module also provides an extendable set of
+    reference APIs for automotive features. It can be used to develop automotive applications and
+    to provide automotive features to Qt-based applications in a structured manner.
+    This reference API already contains so called "simulation backends" which provide partially
+    simulated behavior of a real middleware service.
+
+    \list
+    \li \l{Using the Qt IVI Reference API}
+    \li \l{QtIvi Backends}{Available Backends}
+    \endlist
+
+    \section1 Getting Started with the Qt IVI Reference API
+
+    \list
       \li \l {Qt IVI Vehicle Functions C++ Classes#Getting Started}
              {Getting started with Qt IVI Vehicle Functions (C++)}
       \li \l {Qt IVI Vehicle Functions QML Types#Getting Started}