Put docs release deployment in separate job (#978)

.github/utils/update_docs.sh

@@ -2,8 +2,8 @@
 set -e
 
 echo -e "\n-o- Setting commit user -o-"
-git config --global user.email "dev@optimade.org"
-git config --global user.name "OPTIMADE Developers"
+git config --global user.email "${GIT_USER_EMAIL}"
+git config --global user.name "${GIT_USER_NAME}"
 
 echo -e "\n-o- Update 'API Reference' docs -o-"
 invoke create-api-reference-docs --pre-clean

.github/workflows/cd_release.yml

@@ -5,14 +5,17 @@ on:
     types:
     - published
 
+env:
+  PUBLISH_UPDATE_BRANCH: master
+  GIT_USER_NAME: OPTIMADE Developers
+  GIT_USER_EMAIL: "dev@optimade.org"
+
 jobs:
 
   publish:
     name: Publish OPTIMADE Python tools
     runs-on: ubuntu-latest
     if: github.repository == 'Materials-Consortia/optimade-python-tools' && startsWith(github.ref, 'refs/tags/v')
-    env:
-      PUBLISH_UPDATE_BRANCH: master
 
     steps:
     - name: Checkout repository
@@ -79,6 +82,35 @@ jobs:
         user: __token__
         password: ${{ secrets.PYPI_PASSWORD }}
 
+  docs:
+    name: Deploy documentation
+    needs: publish
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v2
+      with:
+        submodules: true
+        fetch-depth: 0
+        ref: ${{ env.PUBLISH_UPDATE_BRANCH }}
+
+    - name: Set up Python 3.8
+      uses: actions/setup-python@v2
+      with:
+        python-version: 3.8
+
+    - name: Install Python dependencies
+      run: |
+        python -m pip install -U pip
+        pip install -U setuptools
+        pip install -U -e .[all]
+
+    - name: Set git config
+      run: |
+        git config --global user.name "${{ env.GIT_USER_NAME }}"
+        git config --global user.email "${{ env.GIT_USER_EMAIL }}"
+
     - name: Deploy documentation
       run: |
         mike deploy --push --remote origin --branch gh-pages --update-aliases --config-file mkdocs.yml ${GITHUB_REF#refs/tags/v} stable