Add a how do I? page

docs/changelog.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.1.2
+
+### Doc improvements
+
+- Added a ["How do I...?" page](how-to.md) that explains how to do common tasks with `ome-zarr-models`.
+
 ## 0.1.1
 
 ### Bug fixes

docs/how-to.md

@@ -0,0 +1,25 @@
+# How do I...?
+
+## Validate an OME-Zarr group
+
+If you know what type of group it is, use the `to_zarr()` method on [one of the group objects](api/index.md):
+
+```python
+import zarr
+import ome_zarr_models.v04
+
+zarr_group = zarr.open(path_to_group, mode="r")
+hcs_group = ome_zarr_models.v04.HCS.from_zarr(zarr_group)
+```
+
+If you don't know what type of group it is, use `open_ome_zarr()`:
+
+```python
+import zarr
+import ome_zarr_models.v04
+
+zarr_group = zarr.open(path_to_group, mode="r")
+ome_group = ome_zarr_models.open_ome_zarr(zarr_group)
+```
+
+If there aren't any errors, the Zarr group is a valid OME-Zarr group.

mkdocs.yml

@@ -61,6 +61,7 @@ plugins:
 nav:
   - Home: index.md
   - Tutorial: tutorial.py
+  - How do I...?: how-to.md
   - API reference:
       - api/index.md
       - v04: