Doc/update doc (ecmwf#71)

* update doc

docs/building/filters/yaml/rename.yaml

@@ -0,0 +1,4 @@
+rename:
+  param:
+    from: "old"
+    to: "new"

docs/building/sources/netcdf.rst

@@ -4,3 +4,5 @@
 
 .. literalinclude:: yaml/netcdf.yaml
    :language: yaml
+
+.. include:: xarray-based.rst

docs/building/sources/repeated_dates.rst

@@ -2,11 +2,21 @@
  repeated_dates
 ################
 
+The `repeated_dates` source is used to repeat a single source multiple
+times, so that its data is present at multiple dates. A simple example
+of this is when you have source that contains a constant field, such as
+orography or bathymetry, that you want to have repeated at all the dates
+of the dataset.
+
 The generale format of the `repeated_dates` source is:
 
 .. literalinclude:: yaml/repeated_dates1.yaml
    :language: yaml
 
+where ``source`` is any of the :ref:`operations <operations>` or
+:ref:`sources <sources>` described in the previous sections. The
+``mode`` parameter can be one of the following:
+
 **********
  constant
 **********

docs/building/sources/xarray-based.rst

@@ -0,0 +1,13 @@
+This source uses Xarray_ internally to access the data, and assumes that
+it follows the `CF conventions`_.
+
+You specify any valid xarray.open_dataset_ arguments in the source.
+
+.. literalinclude:: yaml/xarray-based.yaml
+   :language: yaml
+
+.. _cf conventions: http://cfconventions.org/
+
+.. _xarray: https://docs.xarray.dev/en/stable/index.html
+
+.. _xarray.open_dataset: https://docs.xarray.dev/en/stable/generated/xarray.open_dataset.html

docs/building/sources/xarray-kerchunk.rst

@@ -2,7 +2,7 @@
  xarray-kerchunk
 #################
 
-.. literalinclude:: xarray-kerchunk.yaml
+.. literalinclude:: yaml/xarray-kerchunk.yaml
    :language: yaml
 
 The code below is inspired by the `kerchunk tutorial`_, and makes use of

docs/building/sources/yaml/xarray-based.yaml

@@ -0,0 +1,3 @@
+input:
+   xarray-based-source: # netcdf, zarr, opendap, etc.
+      group: mygroup