docs: update installation docs

Author: jhamman

docs/conf.py

@@ -91,6 +91,7 @@
      "spec/v3": "https://zarr-specs.readthedocs.io/en/latest/v3/core/v3.0.html",
      "license": "https://github.com/zarr-developers/zarr-python/blob/main/LICENSE.txt",
      "tutorial": "user-guide",
+     "installation": "user-guide/installation.html",
 }
 
 # The language for content autogenerated by Sphinx. Refer to documentation

docs/index.rst

@@ -14,7 +14,6 @@ Zarr-Python
     release
     contributing
     roadmap
-    installation
 
 **Version**: |version|
 

docs/user-guide/index.rst

@@ -6,14 +6,14 @@ User Guide
 .. toctree::
     :maxdepth: 1
 
+    installation
     arrays
     groups
     attributes
     storage
     config
 
 .. Coming soon
-    installation
     v3_migration
 
 Advanced Topics

docs/installation.rst renamed to docs/user-guide/installation.rst

@@ -1,9 +1,23 @@
 Installation
 ============
 
+Required dependencies
+---------------------
+
+Required dependencies include:
+
+- `Python <https://docs.python.org/3/>`_ (3.11 or later)
+- `packaging <https://packaging.pypa.io>`_ (22.0 or later)
+- `numpy <https://numpy.org>`_ (1.25 or later)
+- `numcodecs[crc32c] <https://numcodecs.readthedocs.io>`_ (0.14 or later)
+- `typing_extensions <https://typing-extensions.readthedocs.io>`_ (4.9 or later)
+- `donfig <https://donfig.readthedocs.io>`_ (0.8 or later)
+
 pip
 ---
 
+Zarr is available on `PyPI <https://pypi.org/project/zarr/>`_. Install it using ``pip``:
+
 .. code-block:: console
 
     $ pip install zarr
@@ -12,12 +26,15 @@ There are a number of optional dependency groups you can install for extra funct
 These can be installed using ``pip install "zarr[<extra>]"``, e.g. ``pip install "zarr[gpu]"``
 
 - ``gpu``: support for GPUs
-- ``fsspec``: support for reading/writing to remote data stores
-- ``tree``: support for pretty printing of directory trees
+- ``remote``: support for reading/writing to remote data stores
+
+Additional option dependencies include ``rich``, ``universal_pathlib``. These must be installed separately.
 
 conda
 -----
 
+Zarr is also published to `conda-forge <https://conda-forge.org>`_. Install it using ``conda``:
+
 .. code-block:: console
 
     $ conda install -c conda-forge zarr
@@ -34,4 +51,4 @@ Zarr has endorsed `Scientific-Python SPEC 0 <https://scientific-python.org/specs
 
 Development
 -----------
-To install the latest development version of Zarr, see `the contributing guide <contributing.html>`_.
+To install the latest development version of Zarr, see `the contributing guide <../developers/contributing.html>`_.