Try to publish generated_docs from PR sources and comment on the PR

Author: oleksandr-pavlyk

.github/workflows/generate-docs.yml

@@ -3,6 +3,8 @@ on:
   push:
     branches:
       - master
+  pull_request:
+
 
 jobs:
   build-and-deploy:
@@ -66,9 +68,12 @@ jobs:
           make Sphinx
           cd ..
           mv generated_docs/docs ~/docs
+          ls -l ~/docs
           git clean -dfx
+          ls -l ~/docs
           cd ..
       - name: Publish docs
+        if: ${{ github.ref == 'refs/heads/master' }}
         shell: bash -l {0}
         run: |
           git remote add tokened_docs https://IntelPython:${{ secrets.GITHUB_TOKEN }}@github.com/IntelPython/dpctl.git
@@ -80,6 +85,36 @@ jobs:
           mv ~/docs/* .
           git add .
           git config --global user.name 'github-actions[doc-deploy-bot]'
-          git config --gloabl user.email 'github-actions[doc-deploy-bot]@users.noreply.github.com'
+          git config --global user.email 'github-actions[doc-deploy-bot]@users.noreply.github.com'
           git commit -m "Latest docs."
           git push tokened_docs gh-pages
+      - name: Publish pull-request docs
+        if: ${{ github.ref != 'refs/heads/master' }}
+        env:
+          PR_NUM: ${{ github.event.number }}
+        shell: bash -l {0}
+        run: |
+          git remote add tokened_docs https://IntelPython:${{ secrets.GITHUB_TOKEN }}@github.com/IntelPython/dpctl.git
+          git fetch tokened_docs
+          git checkout --track tokened_docs/gh-pages
+          echo `pwd`
+          mkdir -p pulls/${PR_NUM}
+          cd pulls/${PR_NUM}
+          git rm -rf *
+          ls -l ~
+          mv ~/docs/* .
+          git add .
+          git config --global user.name 'github-actions[doc-deploy-bot]'
+          git config --global user.email 'github-actions[doc-deploy-bot]@users.noreply.github.com'
+          git commit -m "Docs for pull request ${PR_NUM}"
+          git push tokened_docs gh-pages
+      - name: Comment with URL to pull-request docs
+        if: ${{ github.ref != 'refs/heads/master' }}
+        env:
+          PR_NUM: ${{ github.event.number }}
+        uses: mshick/add-pr-comment@v1
+        with:
+          message: |
+            View rendered docs @ https://intelpython.github.io/dpctl/pulls/${PR_NUM}/index.html
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          repo-token-user-login: 'github-actions[bot]'