prepare the release of v0.2 (#101)

* fix the markup

* collapse the data in DataArray HTML reprs

* mention the unit-aware methods

* reword [skip-ci]

* add missing word [skip-ci]

Author: keewis

docs/examples/plotting.ipynb

@@ -16,7 +16,10 @@
    "outputs": [],
    "source": [
     "import xarray as xr\n",
-    "import pint_xarray"
+    "import pint_xarray\n",
+    "from pint_xarray import unit_registry as ureg\n",
+    "\n",
+    "xr.set_options(display_expand_data=False)"
    ]
   },
   {
@@ -105,6 +108,27 @@
     "monthly_means"
    ]
   },
+  {
+   "cell_type": "markdown",
+   "id": "14ea5eb8",
+   "metadata": {},
+   "source": [
+    "Most operations will preserve the units but there are some which will drop them (see the [duck array integration status](https://xarray.pydata.org/en/stable/user-guide/duckarrays.html#missing-features) page). To work around that there are unit-aware versions on the `.pint` accessor. For example, to select data use `.pint.sel` instead of `.sel`:"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": null,
+   "id": "93e4ca4e",
+   "metadata": {},
+   "outputs": [],
+   "source": [
+    "monthly_means.pint.sel(\n",
+    "    lat=ureg.Quantity(4350, \"angular_minute\"),\n",
+    "    lon=ureg.Quantity(12000, \"angular_minute\"),\n",
+    ")"
+   ]
+  },
   {
    "cell_type": "markdown",
    "id": "still-ebony",
@@ -142,7 +166,7 @@
    "name": "python",
    "nbconvert_exporter": "python",
    "pygments_lexer": "ipython3",
-   "version": "3.8.6"
+   "version": "3.9.2"
   }
  },
  "nbformat": 4,

docs/whats-new.rst

@@ -5,8 +5,9 @@ What's new
 
 0.2 (*unreleased*)
 ------------------
-- rewrite :py:meth:`Dataset.pint.quantify` and :py:meth:`DataArray.pint.quantify`,
-  to use pint's `parse_units` instead of `parse_expression` (:pull:`40`)
+- rewrite :py:meth:`Dataset.pint.quantify` and :py:meth:`DataArray.pint.quantify`, to
+  use pint's ``UnitRegistry.parse_units`` instead of ``UnitRegistry.parse_expression``
+  (:pull:`40`)
   By `Tom Nicholas <https://github.com/TomNicholas>`_.
 - ensure the variables which causes the error is explicit if an error occurs in
   :py:meth:`Dataset.pint.quantify` and other methods (:pull:`43`, :pull:`91`)