Merge fc6f551 into 9133fff

HOWTORELEASE.rst

@@ -1,7 +1,7 @@
 Release Procedure
 -----------------
 
-#. Create a new branch ``release-vX.x.x`` with the version for the release.
+#. Create a new branch ``release-v0.0.x`` with the version for the release.
 
  * Update ``CHANGELOG.rst``
  * Make sure all new changes, features are reflected in the documentation.
@@ -12,7 +12,7 @@ Release Procedure
 
 #. Tag a release and push to github::
 
-    $ git tag -a v1.0.0 -m "Version 1.0.0"
+    $ git tag -a v0.0.17 -m "Version 0.0.17"
     $ git push origin master --tags
 
 #. Build and publish release on PyPI::

ci/doc.yml

@@ -0,0 +1,14 @@
+name: xskillscore-docs
+channels:
+  - conda-forge
+dependencies:
+  - python=3.6
+  - bottleneck
+  - importlib_metadata
+  - nbsphinx
+  - numpy
+  - sphinx
+  - sphinxcontrib-napoleon
+  - sphinx_rtd_theme
+  - toolz
+  - xarray 

docs/source/conf.py

@@ -6,11 +6,27 @@
 
 import datetime
 import os
+import pathlib
+import subprocess
 import sys
 
+root = pathlib.Path(__file__).absolute().parent.parent
+os.environ["PYTHONPATH"] = str(root)
+sys.path.insert(0, str(root))
+
 import xskillscore
 
-sys.path.insert(0, os.path.abspath('../..'))
+print("python exec:", sys.executable)
+print("sys.path:", sys.path)
+
+if "conda" in sys.executable:
+    print("conda environment:")
+    subprocess.run(["conda", "list"])
+else:
+    print("pip environment:")
+    subprocess.run(["pip", "list"])
+
+print("xskillscore: %s, %s" % (xskillscore.__version__, xskillscore.__file__))
 
 # -- Project information -----------------------------------------------------
 current_year = datetime.datetime.now().year

readthedocs.yml

@@ -0,0 +1,12 @@
+version: 2
+
+build:
+    image: latest
+
+conda:
+    environment: ci/doc.yml
+
+sphinx:
+  fail_on_warning: true
+
+formats: []