fix broken code examples

Author: d-v-b

src/zarr/core/array.py

@@ -4014,7 +4014,7 @@ def blocks(self) -> BlockIndex:
     def resize(self, new_shape: ShapeLike) -> None:
         """
         Change the shape of the array by growing or shrinking one or more
-        dimensions.
+        dimensions. This is an in-place operation that modifies the array.
 
         Parameters
         ----------
@@ -4032,20 +4032,20 @@ def resize(self, new_shape: ShapeLike) -> None:
 
         Examples
         --------
-        >>> import zarr
-        >>> z = zarr.zeros(shape=(10000, 10000),
-        >>>                chunk_shape=(1000, 1000),
-        >>>                dtype="i4",)
-        >>> z.shape
-        (10000, 10000)
-        >>> z = z.resize(20000, 1000)
-        >>> z.shape
-        (20000, 1000)
-        >>> z2 = z.resize(50, 50)
-        >>> z.shape
-        (20000, 1000)
-        >>> z2.shape
-        (50, 50)
+        ```python
+        import zarr
+        z = zarr.zeros(shape=(10000, 10000),
+                        chunk_shape=(1000, 1000),
+                        dtype="int32",)
+        z.shape
+        #> (10000, 10000)
+        z.resize((20000, 1000))
+        z.shape
+        #> (20000, 1000)
+        z.resize((50, 50))
+        z.shape
+        #>(50, 50)
+        ```
         """
         sync(self._async_array.resize(new_shape))
 

src/zarr/core/attributes.py

@@ -43,11 +43,11 @@ def put(self, d: dict[str, JSON]) -> None:
         Equivalent to the following pseudo-code, but performed atomically.
 
         ```python
-        >>> attrs = {"a": 1, "b": 2}
-        >>> attrs.clear()
-        >>> attrs.update({"a": 3", "c": 4})
-        >>> attrs
-        {'a': 3, 'c': 4}
+        attrs = {"a": 1, "b": 2}
+        attrs.clear()
+        attrs.update({"a": "3", "c": 4})
+        print(attrs)
+        #> {'a': '3', 'c': 4}
         ```
         """
         self._obj.metadata.attributes.clear()

src/zarr/core/dtype/npy/string.py

@@ -99,6 +99,7 @@ class FixedLengthUTF32JSON_V3(NamedConfig[Literal["fixed_length_utf32"], LengthB
         "name": "fixed_length_utf32",
         "configuration": {
             "length_bytes": 12
+            }
     }
     ```
     """

src/zarr/core/dtype/npy/structured.py

@@ -74,7 +74,7 @@ class StructuredJSON_V3(
         "name": "structured",
         "configuration": {
             "fields": [
-                ["f0", "int32],
+                ["f0", "int32"],
                 ["f1", "float64"],
             ]
         }