Also install the package in the docs (#143)

.readthedocs.yaml

@@ -6,4 +6,5 @@ build:
 conda:
   environment: docs/environment.yml
 sphinx:
-   configuration: docs/conf.py
+  configuration: docs/conf.py
+  fail_on_warning: true

BUILD_HOWTO.rst

@@ -14,34 +14,14 @@ Sphinx Documentation has an excellent `introduction to reST
 <http://sphinx.pocoo.org/rest.html>`__. Review the Sphinx docs to perform more
 complex changes to the documentation as well.
 
-How to build the documentation
-------------------------------
-
-Requirements
-~~~~~~~~~~~~
-
-There are some extra requirements to build the docs: you will need to
-have ``sphinx``, ``sphinx-book-theme``, ``numpydoc`` and ``ipython`` installed.
-
-We recommend to use conda (or mamba) to create an environment for oggm-edu. 
-Create a text file called `oggm_edu_docs.yaml` with the following content 
-in it::
-
-
-  name: oggm_edu_docs
-  channels:
-    - conda-forge
-  dependencies:
-    - sphinx 
-    - sphinx-book-theme
-    - ipython
-    - numpydoc
-    - sphinx-intl
-
-Then, from your `base` environment, do `mamba env create -f oggm_edu_docs.yml` 
-(or `conda env create -f oggm_edu_docs.yml`). To activate the environment,
-type: `conda activate oggm_edu_docs`.
-
+Installation
+------------
+
+Download (or clone) the latest version of the oggm-edu repository.
+From the repository's root folder, activate conda if necessary and then,
+from your `base` environment, run ``mamba env create -f docs/environment.yml``
+(or ``conda env create -f docs/environment.yml``). To activate the environment,
+type: ``conda activate oggm_edu_docs``.
 
 Building the documentation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~

docs/environment.yml

@@ -38,4 +38,6 @@ dependencies:
     - joblib
     - progressbar2
     - git+https://github.com/OGGM/pytest-mpl
-    - oggm
+    - oggm
+    # relative to this file. Needs to be editable to be accepted.
+    - -e ..