CI Updates: live debugging for PRs only + docs deployment (#680)

* CI Updates: live debugging for PRs only + docs deployment

Co-authored-by: Ioannis Magkanaris <iomagkanaris@gmail.com>

Author: alexsavulescu

.github/workflows/coreneuron-ci.yml

@@ -8,7 +8,6 @@ on:
   push:
     branches:
       - master
-      - live-debug*
       - release/**
   pull_request:
     branches:
@@ -140,11 +139,13 @@ jobs:
           PYTHON_VERSION:  ${{ matrix.config.py_version || env.DEFAULT_PY_VERSION }}
 
       # This step will set up an SSH connection on tmate.io for live debugging.
-      # To trigger it, simply prefix your branch name with `live-debug`
-      #   i.e.: live-debug-hocfix
-      - name: live debug session on failure
-        if: failure() && startsWith(github.ref, 'refs/heads/live-debug')
+      # To enable it, you have to:
+      #   * add 'live-debug-ci' to your PR title
+      #   * push something to your PR branch (note that just re-running the pipeline disregards the title update)
+      - name: live debug session on failure (manual steps required, check `.github/workflows/coreneuron-ci.yml`)
+        if: failure() && contains(github.event.pull_request.title, 'live-debug-ci')
         uses: mxschmitt/action-tmate@v3
+
       - name: Documentation
         if: ${{ startsWith(matrix.os, 'ubuntu') && matrix.config.documentation == 'ON' }}
         id: documentation
@@ -158,11 +159,10 @@ jobs:
           touch .nojekyll;
           echo ::set-output name=status::done
           
-#       - name: Deploy 🚀
-#         uses: JamesIves/github-pages-deploy-action@3.7.1
-#         if: steps.documentation.outputs.status == 'done'
-#         with:
-#           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-#           BRANCH: gh-pages # The branch the action should deploy to.
-#           FOLDER: ${{runner.workspace}}/nrn/build/docs # The folder the action should deploy.
-#           CLEAN: false # Automatically remove deleted files from the deploy branch
+      - name: Deploy 🚀
+        uses: JamesIves/github-pages-deploy-action@4.1.5
+        if: steps.documentation.outputs.status == 'done' && github.ref == 'refs/heads/master'
+        with:
+          branch: gh-pages # The branch the action should deploy to.
+          folder: ${{runner.workspace}}/nrn/docs/_build # The folder the action should deploy.
+          single-commit: true #have a single commit on the deployment branch instead of maintaining the full history

.github/workflows/coverage.yml

@@ -8,7 +8,6 @@ on:
   push:
     branches:
       - master
-      - live-debug*
       - release/**
   pull_request:
     branches: