Temporary publish rendered docs to this PR

Author: vlad-perevezentsev

.github/workflows/build-docs.yml

@@ -68,6 +68,37 @@ jobs:
         with:
           name: ${{ env.PACKAGE_NAME }} rendered documentation
           path: ~/rendered_docs
+      # TEMPORARY: publish this PR's docs to gh-pages and comment the link.
+      # Remove after review.
+      - name: Publish pull-request docs
+        if: ${{ github.event.pull_request && github.event.action != 'closed' }}
+        env:
+          PR_NUM: ${{ github.event.number }}
+        shell: bash -l {0}
+        run: |
+          git remote add tokened_docs https://IntelPython:${{ secrets.GITHUB_TOKEN }}@github.com/IntelPython/mkl_random.git
+          git fetch tokened_docs
+          git checkout --track tokened_docs/gh-pages
+          [ -d "pull/${PR_NUM}" ] && git rm -rf "pull/${PR_NUM}"
+          mkdir -p "pull/${PR_NUM}"
+          cd "pull/${PR_NUM}"
+          mv ~/rendered_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 published pull-request docs
+        if: ${{ github.event.pull_request && github.event.action != 'closed' }}
+        env:
+          PR_NUM: ${{ github.event.number }}
+        uses: mshick/add-pr-comment@ec328af66588ab8f77cdeb2c264f14aba45bbf59 # v2
+        with:
+          message-id: url_to_docs
+          allow-repeats: false
+          message: |
+            View rendered docs @ https://intelpython.github.io/mkl_random/pull/${{ env.PR_NUM }}/index.html
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
       - name: Configure git
         if: ${{ !github.event.pull_request && github.event.action != 'closed'}}
         run: |