Enable defining parameter and dataset together to precisely select th…

…e source dataset

CHANGELOG.rst

@@ -4,7 +4,23 @@ Changelog
 Development
 ***********
 
-...
+Added
+=====
+
+- Enable selecting a parameter precisely from a dataset by passing a tuple like [("precipitation_height", "kl")] or
+  [("precipitation_height", "precipitation_more")], or for cli/restapi use "precipitation_height/kl"
+
+Changed
+=======
+
+Deprecated
+==========
+
+Removed
+=======
+
+Fixed
+=====
 
 0.20.3 (15.07.2021)
 *******************

docs/usage/python-api.rst

@@ -63,7 +63,7 @@ different ways:
 
         "kl"
 
-This leaves a lot flexibility to the user defining the arguments either by what they
+This leaves a lot of flexibility to the user defining the arguments either by what they
 know from the weather service or what they know from `wetterdienst` itself.
 
 Typical requests are defined by three arguments:
@@ -126,7 +126,7 @@ to discover available parameters based on the given filter arguments.
 Stations
 --------
 
-Get station information for a given *parameter/parameter_set*, *resolution* and
+Get station information for a given *parameter/dataset*, *resolution* and
 *period*.
 
 .. ipython:: python

docs/usage/python-examples.rst

@@ -50,7 +50,7 @@ Get stations for daily historical precipitation:
 
     print(stations.all().df.head())
 
-Get data for a parameter set:
+Get data for a dataset:
 
 .. ipython:: python
 
@@ -84,6 +84,21 @@ Get data for a parameter:
 
     print(next(stations.all().values.query()))
 
+Get data for a parameter from another dataset:
+
+.. ipython:: python
+
+    from wetterdienst import Wetterdienst, Resolution, Period
+
+    API = Wetterdienst(provider="dwd", kind="observation")
+
+    observation_data = API(
+        parameter=[("precipitation_height", "precipitation_more")],
+        resolution=Resolution.DAILY,
+        period=Period.HISTORICAL
+    )
+
+    print(next(stations.all().values.query()))
 
 *********************
 DWD: MOSMIX forecasts