api: hide zarr.core from api docs

Author: jhamman

docs/conf.py

@@ -71,7 +71,7 @@ def skip_submodules(
       ) -> bool:
     # Skip documenting zarr.codecs submodules
     # codecs are documented in the main zarr.codecs namespace
-    if what == "module" and name.startswith("zarr.codecs."):
+    if what == "module" and name.startswith("zarr.codecs.") or name.startswith("zarr.core"):
         skip = True
     return skip
 

src/zarr/core/__init__.py

@@ -1,3 +1,8 @@
+"""
+The ``zarr.core`` module is considered private API and should not be imported
+directly by 3rd-party code.
+"""
+
 from __future__ import annotations
 
 from zarr.core.buffer import Buffer, NDBuffer  # noqa: F401