MAINT: update documentation with releases

.gitlab-ci.yml

@@ -118,16 +118,14 @@ unittest:
       - tox
 
 # Build the sphinx documentation and make it ready for deployment by Gitlab Pages
-# documentation:
-#   stage: deploy
-
 # Special job for serving a static website. See https://docs.gitlab.com/ee/ci/yaml/README.html#pages
-pages:
-  stage: deploy
-  image: $CI_REGISTRY_IMAGE
+pages_prepare: &pages_prepare
   tags: [docker]
+  image: $CI_REGISTRY_IMAGE
+  stage: deploy
   only:
-    - dev
+    refs:
+      - /^release-.*$/
   script:
     - echo "Deploying"
     - make doc
@@ -135,3 +133,9 @@ pages:
   artifacts:
     paths:
       - public
+pages:
+  <<: *pages_prepare
+  only:
+    refs:
+      # version tags: v0.1.1
+      - /^v(\d+\.\d+\.\d+)$/