diff --git a/docs/installation.rst b/docs/installation.rst index 4637695..4e549c8 100644 --- a/docs/installation.rst +++ b/docs/installation.rst @@ -15,7 +15,7 @@ Install from pip: .. code-block:: bash - pip install geocube + python -m pip install geocube Use `conda `__ with the `conda-forge `__ channel: @@ -24,7 +24,23 @@ Use `conda `__ with the `conda-forge `__ + +.. note:: + "... we recommend always installing your packages inside a + new environment instead of the base environment from + anaconda/miniconda. Using envs make it easier to + debug problems with packages and ensure the stability + of your root env." + -- https://conda-forge.org/docs/user/tipsandtricks.html + +.. warning:: + Avoid using `pip install` with a conda environment. If you encounter + a python package that isn't in conda-forge, consider submitting a + recipe: https://github.com/conda-forge/staged-recipes/ From source