Doc: language/style review datavisualization doc

Task-number: QTBUG-33360
Change-Id: Ib6918dcc4c0ee213dddb118616940306a10001fa
Reviewed-by: Miikka Heikkinen <miikka.heikkinen@digia.com>

3 files changed, 38 insertions, 37 deletions

diff --git a/src/datavisualization/doc/src/qtdatavisualization-index.qdoc b/src/datavisualization/doc/src/qtdatavisualization-index.qdoc
index f2245c12..456f8ac5 100644
--- a/src/datavisualization/doc/src/qtdatavisualization-index.qdoc
+++ b/src/datavisualization/doc/src/qtdatavisualization-index.qdoc
@@ -19,7 +19,7 @@
 /*!
     \title Qt Data Visualization
     \page qtdatavisualization-index.html
-    \brief QtDataVisualization module provides functionality for 3D visualization.
+    \brief Provides functionality for 3D visualization.
 
     Qt Data Visualization module provides a way to visualize data in 3D.
 
@@ -28,7 +28,7 @@
     \list
         \li Multiple data visualization options: 3D Bars, 3D Scatter, and 3D Surface
         \li 2D slice views of the 3D data
-        \li Interactive data: Rotate, zoom, and highlight data using mouse or touch
+        \li Interactive data: rotate, zoom, and highlight data using mouse or touch
         \li Uses OpenGL for rendering the data
         \li QML2 support
         \li Customizable axes for data - control viewable data window with axis ranges
@@ -50,14 +50,14 @@
 
     \snippet doc_src_qtdatavisualization.cpp 0
 
-    \note If you are using a few classes from this module, we recommend including those specific
-    classes only instead of the whole module.
+    \note If you are only using a few classes from this module, we recommend including only those
+    specific classes instead of the whole module.
 
-    To link against Qt Data Visualization module, add this line to your \c qmake project file:
+    To link against the Qt Data Visualization module, add this line to your \c qmake project file:
 
     \snippet doc_src_qtdatavisualization.pro 0
 
-    See \l{Qt Data Visualization Getting Started}{Getting started} page for further information
+    See the \l{Qt Data Visualization Getting Started}{Getting started} page for further information on
     how to use Qt Data Visualization in your application.
 
     \section1 Articles
diff --git a/src/datavisualization/doc/src/qtdatavisualization-qml-surface3d.qdoc b/src/datavisualization/doc/src/qtdatavisualization-qml-surface3d.qdoc
index ecc40cdf..c55b7ec1 100644
--- a/src/datavisualization/doc/src/qtdatavisualization-qml-surface3d.qdoc
+++ b/src/datavisualization/doc/src/qtdatavisualization-qml-surface3d.qdoc
@@ -22,11 +22,11 @@
   \inqmlmodule com.digia.QtDataVisualization
   \since com.digia.QtDataVisualization 1.0
   \ingroup datavisualization_qml
-  \brief 3D surface graph.
+  \brief Describes the usage of the 3D surface graph.
 
   This type enables developers to render surface plots in 3D with Qt Quick 2.
 
-  You will need to import data visualization module to use this type:
+  You will need to import the data visualization module to use this type:
 
   \snippet doc_src_qmldatavisualization.cpp 0
 
@@ -53,7 +53,7 @@
 
   If an axis is not given, a temporary default axis with no labels and automatically adjusting
   range is created.
-  This temporary axis is destroyed if another axis is explicitly set to same orientation.
+  This temporary axis is destroyed if another axis is explicitly set to the same orientation.
  */
 
 /*!
@@ -62,7 +62,7 @@
 
   If an axis is not given, a temporary default axis with no labels and automatically adjusting
   range is created.
-  This temporary axis is destroyed if another axis is explicitly set to same orientation.
+  This temporary axis is destroyed if another axis is explicitly set to the same orientation.
  */
 
 /*!
@@ -71,17 +71,17 @@
 
   If an axis is not given, a temporary default axis with no labels and automatically adjusting
   range is created.
-  This temporary axis is destroyed if another axis is explicitly set to same orientation.
+  This temporary axis is destroyed if another axis is explicitly set to the same orientation.
  */
 
 /*!
   \qmlproperty bool Surface3D::smoothSurfaceEnabled
-  Smoothing of surface. If false, shading of the surface is flat.
+  The smoothing of surface. If false, the shading of the surface is flat.
  */
 
 /*!
   \qmlproperty bool Surface3D::surfaceGridEnabled
-  Surface grid visibility. If false, no surface grid is drawn.
+  The surface grid visibility. If false, no surface grid is drawn.
  */
 
 /*!
diff --git a/src/datavisualization/doc/src/qtdatavisualization.qdoc b/src/datavisualization/doc/src/qtdatavisualization.qdoc
index 92f8cc55..393bd6f9 100644
--- a/src/datavisualization/doc/src/qtdatavisualization.qdoc
+++ b/src/datavisualization/doc/src/qtdatavisualization.qdoc
@@ -23,7 +23,7 @@
 
     \brief C++ classes for the Qt Data Visualization API.
 
-    Qt Data Visualization functionality can be accessed via these C++ classes.
+    The Qt Data Visualization functionality can be accessed via these C++ classes.
 */
 
 /*!
@@ -33,7 +33,7 @@
 
     \brief QML types for the Qt Data Visualization API.
 
-    Qt Data Visualization functionality can be accessed via these QML types.
+    The Qt Data Visualization functionality can be accessed via these QML types.
 
     \section1 QML Types
 */
@@ -57,7 +57,7 @@
 
     \section1 Building Qt Data Visualization
 
-    To build Qt Data Visualization module, set up a command prompt with an environment for
+    To build the Qt Data Visualization module, set up a command prompt with an environment for
     building Qt applications, navigate to the directory containing \c qtdatavisualization.pro, and
     configure the project with qmake:
     \code
@@ -122,8 +122,8 @@
 
     \section1 Running examples
 
-    Qt Data Visualization examples are found under \c examples subdirectory. To build and run a
-    single example, e.g. the qmlsurface example, navigate to the example directory and give the
+    Qt Data Visualization examples are found under the \c examples subdirectory. To build and run a
+    single example, for example, the qmlsurface example, navigate to the example directory and enter the
     following commands:
 
     \snippet doc_src_qtdatavisualization.cpp 8
@@ -143,12 +143,13 @@
     \snippet doc_src_qtdatavisualization.cpp 0
 
     Then, add the sample code found in one of the following pages, depending on what kind of
-    visualization you are interested in: \l{How to construct a minimal Q3DBars graph},
+    visualization you are interested in:
+    \l{How to construct a minimal Q3DBars graph},
     \l{How to construct a minimal Q3DScatter graph}, or
     \l{How to construct a minimal Q3DSurface graph}.
 
     To use Qt Data Visualization graphs in widget based applications, you can use
-    QWidget::createWindowContainer() function to wrap the graph into a widget:
+    the QWidget::createWindowContainer() function to wrap the graph into a widget:
 
     \snippet doc_src_qtdatavisualization.cpp 9
 
@@ -163,8 +164,8 @@
 
     \section1 Data proxies
 
-    The data users wish to visualize comes in many formats, all of which cannot obviously be
-    directly supported. Therefore Qt Data Visualization implements data proxies into which
+    The data that users wish to visualize comes in many formats, all of which cannot obviously be
+    directly supported. Therefore, Qt Data Visualization implements data proxies into which
     user can feed their data in a known format. Each visualization type has a basic proxy type,
     which takes data in a format suitable for that visualization.
     For example, the basic proxy for Q3DBars is QBarDataProxy, which stores rows of QBarDataItem
@@ -178,7 +179,7 @@
 
     \note The graph objects can own more than one data proxy, but only one proxy can be
     active at a time. If you need to switch back and forth between two different sets of data,
-    it may be more efficient to store each set in different proxy and just change the active
+    it may be more efficient to store each set in a different proxy and just change the active
     proxy, rather than reset the data in one proxy every time you need to switch.
 
     \section1 Item models and data mapping
@@ -186,8 +187,8 @@
     For common use cases, Qt Data Visualization offers specialized proxies. One such case is having
     data in an item model (QAbstractItemModel subclass), which is a common way to store data in
     Qt applications. Each of the visualization types offers a special proxy and a corresponding mapping
-    class for this purpose, e.g. QItemModelBarDataProxy and QItemModelBarDataMapping for Q3DBars.
-    These proxies are simple to use - just give them a pointer to the item model containing the
+    class for this purpose, for example, QItemModelBarDataProxy and QItemModelBarDataMapping for Q3DBars.
+    These proxies are simple to use: just give them a pointer to the item model containing the
     data and the mapping object containing rules how to map the data into format the basic proxy can
     digest.
 
@@ -197,16 +198,16 @@
     and which role specifies the value of the item. When the proxy resolves the data from the model,
     it uses these mappings to generate the rows and columns of the bar graph.
 
-    Depending on the visualization type, mapping classes may support other functionality as well,
+    Depending on the visualization type, mapping classes may support other functionalities as well,
     such as QItemModelBarDataMapping optionally mapping QAbstractItemModel rows and columns directly
     into bar graph rows and columns. See individual mapping classes for more information and examples
-    how to use them: QItemModelBarDataMapping, QItemModelScatterDataMapping, and
+    about how to use them: QItemModelBarDataMapping, QItemModelScatterDataMapping, and
     QItemModelSurfaceDataMapping.
 
     \section1 Other custom proxies
 
     QHeightMapSurfaceDataProxy is a specialized proxy for generating a surface graph from a
-    heightmap image. See QHeightMapSurfaceDataProxy documentation for more information.
+    heightmap image. See the QHeightMapSurfaceDataProxy documentation for more information.
 
     The \l{Custom Proxy Example}{Custom Proxy} example shows how a custom proxy can be created. It
     defines a custom data set based on variant lists and an extension of the basic proxy to resolve
@@ -218,13 +219,13 @@
     ensure good performance. Since memory allocation is a costly operation, always use
     QList::reserve() and QVector::resize() where possible to avoid reallocations when constructing
     the array to give to the proxy. If you need to change the entire data set for each frame,
-    it is in most cases best to re-use the existing array - especially if the array dimensions do not
+    it is in most cases best to reuse the existing array - especially if the array dimensions do not
     change. If you need to add, insert, remove, or change several rows or items for each frame, it
     is always more efficient to do it with one method call instead of multiple calls affecting
     a single row or item each. For example, adding ten rows with a single QBarDataProxy::addRows() call
     is much more efficient than ten separate QBarDataProxy::addRow() calls.
 
-    Bars renderer is optimized to access only data that is within data window and thus should not
+    Bars renderer is optimized to access only data that is within the data window and thus should not
     suffer noticeable slowdown even if more data is continually added to the proxy.
 
     Due to the unsorted nature of the scatter data, any change in the data window ranges requires
@@ -232,9 +233,9 @@
     continually added to the proxy.
 
     Surface data, while on item level similar to scatter data, is already assigned into rows and
-    columns, so the surface renderer can do some optimization by making assumption that the data in
+    columns, so the surface renderer can do some optimization by making the assumption that the data in
     rows and columns is sorted along their respective axes, but it is nowhere near as efficient
-    as in bars case. Surface rendering can suffer significant slowdown if the data size grows unchecked.
+    as in the bars case. Surface rendering can suffer significant slowdown if the data size grows unchecked.
 
     For the best performance with the scatter and surface graphs, only keep the data you need in the
     proxy.
@@ -253,21 +254,21 @@
     see QTouch3DInputHandler documentation.
 
     \note In the technology preview version, default input handlers cannot be replaced or even accessed
-    via public API. This feature is planned for the final release.
+    via the public API. This feature is planned for the final release.
 
     \section1 Data selection modes
 
-    All visualization types support selecting single data item - a bar, a scatter item, or a surface
+    All visualization types support selecting a single data item - a bar, a scatter item, or a surface
     vertex - using mouse, touch, and programmatically via the graph APIs. The selected item is highlighted
     in the rendered graph, and selecting causes emission of a graph specific signal for this purpose,
-    e.g. Q3DBars::selectedBarPosChanged(), which the application can handle.
+    for example, Q3DBars::selectedBarPosChanged(), which the application can handle.
 
-    \note Surface graph doesn't have fully implemented selection API yet, it only supports
+    \note The surface graph doesn't have a fully implemented selection API yet. It only supports
     selection with mouse and touch in the technology preview version.
 
     Bar and surface graphs support slice selection modes, where the selected row or column is drawn
     in a separate viewport as a pseudo-2D graph. This makes it easier to see the actual values of
-    single row or column.
+    a single row or column.
 
     Bar graph additionally supports simply highlighting the whole row and/or column of the selected bar
     without opening the slice view.