From 3350d83ede725d7d5adca1ca4f27b30dfc360e5a Mon Sep 17 00:00:00 2001
From: Alan Snow <alan.snow@corteva.com>
Date: Tue, 4 Jan 2022 14:48:55 -0600
Subject: [PATCH] DOC: Update installation instructions for conda

---
 docs/installation.rst | 20 ++++++++++++++++++--
 1 file changed, 18 insertions(+), 2 deletions(-)

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 <https://conda.io/en/latest/>`__ with the `conda-forge <https://conda-forge.org/>`__ channel:
@@ -24,7 +24,23 @@ Use `conda <https://conda.io/en/latest/>`__ with the `conda-forge <https://conda
 
     conda config --prepend channels conda-forge
     conda config --set channel_priority strict
-    conda install geocube
+    conda create -n geocube_env geocube
+    conda activate geocube_env
+
+- `geocube` `conda-forge repository <http://github.com/conda-forge/geocube-feedstock>`__
+
+.. 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