review doc

Author: floriankrb

docs/using/combining.rst

@@ -28,12 +28,13 @@ e.g. by changing their date range or frequency using :ref:`start`,
  automatic
 ***********
 
-If you just provides a list of datasets, the package will automatically
+If you just provide a list of datasets, the package will automatically
 attempt to combine them:
 
--  If the datasets have the same variable, ensemble dimension and grids,
-   and dates that, once concatenated, create a continuous range of dates
-   a constant frequency, the package will combine using concat_.
+-  If the datasets have the same variables and the same ensemble
+   dimension and the same grids, and if the dates once concatenated,
+   create a continuous range of dates with a constant frequency, the
+   package will combine using concat_.
 
 -  If the datasets have the same dates, ensemble dimension and grids,
    the package will combine using join_.
@@ -56,11 +57,12 @@ chronological order with no gaps between them.
    :align: center
    :alt: Concatenation
 
-Please note that you can pass more than two ``zarr`` files to the
-function.
+Please note that you can pass more than two datasets to the function.
 
-   **NOTE:** When concatenating file, the statistics are not recomputed;
-   it is the statistics of first file that are returned to the user.
+   **NOTE:** When concatenating datasets, the statistics are not
+   recomputed; it is the statistics of first dataset that are returned
+   to the user. You can change this using the
+   :ref:`selecting-statistics` option.
 
 .. _join:
 
@@ -86,7 +88,7 @@ occurrence of that name.
    :align: center
    :alt: Overlay
 
-Please note that you can join more than two ``zarr`` files.
+Please note that you can join more than two datasets.
 
 .. _ensembles:
 

docs/using/grids.rst

@@ -17,10 +17,10 @@ will mask out all but every Nth point, with N specified by the
 .. literalinclude:: code/thinning_.py
    :language: python
 
-Please note that the thinning will apply to all dimension of the fields.
-So for 2D fields, the thinning will apply to both the latitude and
-longitude dimensions. For 1D fields, such as reduced Gaussian grids, the
-thinning will apply to the only dimension.
+Please note that the thinning will apply to all dimensions of the
+fields. So for 2D fields, the thinning will apply to both the latitude
+and longitude dimensions. For 1D fields, such as reduced Gaussian grids,
+the thinning will apply to the only dimension.
 
 The following example shows the effect of thinning a dataset with a 1
 degree resolution:

docs/using/selecting.rst

@@ -64,5 +64,5 @@ You can also rename variables:
 .. literalinclude:: code/rename_.py
    :language: python
 
-This will be useful when your join datasets and do not want variables
+This will be useful when you join datasets and do not want variables
 from one dataset to override the ones from the other.