refactor to rst

IAMconsortium · Jun 3, 2020 · f0505e8 · f0505e8
1 parent 2cd495e
commit f0505e8
Showing 1 changed file with 8 additions and 4 deletions.
diff --git a/pyam/iiasa.py b/pyam/iiasa.py
@@ -356,10 +356,14 @@ def query(self, **kwargs):
         Examples
         --------
 
-        ```
-        Connection.query(model='MESSAGE', scenario='SSP2*',
-                         variable=['Emissions|CO2', 'Primary Energy'])
-        ```
+        You can read from a :class:`pyam.iiasa.Connection` instance using
+        keyword arguments similar to filtering an :class:`IamDataFrame`:
+
+        .. code-block:: python
+
+            Connection.query(model='MESSAGE', scenario='SSP2*',
+                             variable=['Emissions|CO2', 'Primary Energy'])
+
         """
         headers = {
             'Authorization': 'Bearer {}'.format(self._token),