better docstrings, better docs

docs/api/v2.md

@@ -0,0 +1 @@
+::: pydantic_zarr.v2

docs/api/v3.md

@@ -0,0 +1 @@
+::: pydantic_zarr.v3

docs/usage_zarr_v2.md

@@ -132,7 +132,7 @@ except ValidationError as exc:
     1 validation error for GroupSpec[GroupAttrs, ~TItem]
     attributes.b
       Input should be a valid integer, unable to parse string as an integer [type=int_parsing, input_value='foo', input_type=str]
-        For further information visit https://errors.pydantic.dev/2.4/v/int_parsing
+        For further information visit https://errors.pydantic.dev/2.6/v/int_parsing
     """
 
 # this passes validation
@@ -151,7 +151,7 @@ except ValidationError as exc:
     1 validation error for GroupSpec[~TAttr, ArraySpec]
     members.foo
       Input should be a valid dictionary or instance of ArraySpec [type=model_type, input_value=GroupSpec(zarr_version=2,...tributes={}, members={}), input_type=GroupSpec]
-        For further information visit https://errors.pydantic.dev/2.4/v/model_type
+        For further information visit https://errors.pydantic.dev/2.6/v/model_type
     """
 
 # this passes validation

mkdocs.yaml

@@ -30,14 +30,23 @@ nav:
     - About: index.md
     - Usage (Zarr V3): usage_zarr_v3.md
     - Usage (Zarr V2): usage_zarr_v2.md
-    - API: api/core.md
+    - API:
+      - core: api/core.md
+      - v2: api/v2.md
+      - v3: api/v3.md
 
 plugins:
 - mkdocstrings:
     handlers:
         python:
           options:
-            show_signature_annotations: true
+            docstring_style: numpy
+            members_order: source
+            separate_signature: true
+            filters: ["!^_"]
+            docstring_options:
+              ignore_init_summary: true
+            merge_init_into_class: true
 
 markdown_extensions:
   - pymdownx.highlight:

src/pydantic_zarr/core.py

@@ -1,5 +1,13 @@
 from __future__ import annotations
-from typing import Any, Dict, Literal, Mapping, Set, TypeAlias, Union
+from typing import (
+    Any,
+    Dict,
+    Literal,
+    Mapping,
+    Set,
+    TypeAlias,
+    Union,
+)
 from pydantic import BaseModel, ConfigDict
 
 IncEx: TypeAlias = Union[Set[int], Set[str], Dict[int, Any], Dict[str, Any], None]