diff --git a/docs/index.rst b/docs/index.rst index f4afc9fd85..007c8d010f 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -25,44 +25,13 @@ Zarr is still a young project. Feedback and bug reports are very welcome, please the `GitHub issue tracker `_. See :doc:`contributing` for further information about contributing to Zarr. -Installation ------------- - -Zarr depends on NumPy. It is generally best to `install NumPy -`_ first using whatever method is most -appropriate for you operating system and Python distribution. Other dependencies should be -installed automatically if using one of the installation methods below. - -Install Zarr from PyPI:: - - $ pip install zarr - -Alternatively, install Zarr via conda:: - - $ conda install -c conda-forge zarr - -To install the latest development version of Zarr, you can use pip with the -latest GitHub main:: - - $ pip install git+https://github.com/zarr-developers/zarr-python.git - -To work with Zarr source code in development, install from GitHub:: - - $ git clone --recursive https://github.com/zarr-developers/zarr-python.git - $ cd zarr-python - $ python setup.py install - -To verify that Zarr has been fully installed, run the test suite:: - - $ pip install pytest - $ python -m pytest -v --pyargs zarr - Contents -------- .. toctree:: :maxdepth: 2 + installation tutorial api spec diff --git a/docs/installation.rst b/docs/installation.rst new file mode 100644 index 0000000000..47c1dee269 --- /dev/null +++ b/docs/installation.rst @@ -0,0 +1,31 @@ +Installation +============ + +Zarr depends on NumPy. It is generally best to `install NumPy +`_ first using whatever method is most +appropriate for you operating system and Python distribution. Other dependencies should be +installed automatically if using one of the installation methods below. + +Install Zarr from PyPI:: + + $ pip install zarr + +Alternatively, install Zarr via conda:: + + $ conda install -c conda-forge zarr + +To install the latest development version of Zarr, you can use pip with the +latest GitHub main:: + + $ pip install git+https://github.com/zarr-developers/zarr-python.git + +To work with Zarr source code in development, install from GitHub:: + + $ git clone --recursive https://github.com/zarr-developers/zarr-python.git + $ cd zarr-python + $ python setup.py install + +To verify that Zarr has been fully installed, run the test suite:: + + $ pip install pytest + $ python -m pytest -v --pyargs zarr \ No newline at end of file