Docs deploy action (apache#721)

* ci: add debug print for githuc docs actions

* ci: update docs job condition

Author: Michael-J-Ward

.github/workflows/docs.yaml

@@ -11,12 +11,21 @@ on:
 name: Deploy DataFusion Python site
 
 jobs:
+  debug-github-context:    
+    name: Print github context
+    runs-on: ubuntu-latest
+    steps:
+    - name: Dump GitHub context
+      env:
+        GITHUB_CONTEXT: ${{ toJson(github) }}
+      run: |
+        echo "$GITHUB_CONTEXT"
   build-docs:
     name: Build docs
     runs-on: ubuntu-latest
     steps:
       - name: Set target branch
-        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        if: github.event_name == 'push' && (github.ref == 'refs/heads/main' || github.ref_type == 'tag')
         id: target-branch
         run: |
           set -x
@@ -31,7 +40,7 @@ jobs:
       - name: Checkout docs sources
         uses: actions/checkout@v3
       - name: Checkout docs target branch
-        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        if: github.event_name == 'push' && (github.ref == 'refs/heads/main' || github.ref_type == 'tag')
         uses: actions/checkout@v3
         with:
           fetch-depth: 0
@@ -69,7 +78,7 @@ jobs:
           make html
 
       - name: Copy & push the generated HTML
-        if: github.event_name == 'push' && github.ref == 'refs/heads/main'
+        if: github.event_name == 'push' && (github.ref == 'refs/heads/main' || github.ref_type == 'tag')
         run: |
           set -x
           cd docs-target