api: hide zarr.core from api docs (#2669)

* api: hide zarr.core from api docs

* dont link to zarr.config doc module

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
 

docs/user-guide/config.rst

@@ -3,7 +3,7 @@
 Runtime configuration
 =====================
 
-:mod:`zarr.config <zarr.core.config>` is responsible for managing the configuration of zarr and
+``zarr.config`` is responsible for managing the configuration of zarr and
 is based on the `donfig <https://github.com/pytroll/donfig>`_ Python library.
 
 Configuration values can be set using code like the following::

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