Fixes apache#5500 - Add a Github Actions workflow that builds the docs

Signed-off-by: Martin Tzvetanov Grigorov <[email protected]>

.github/workflows/docs.yaml

@@ -0,0 +1,57 @@
+on:
+  push:
+    branches:
+      - master
+      - issue-5500-asf.yaml-docs
+    paths:
+      - .github/workflows/docs.yaml
+      - docs/**
+
+name: Deploy DataFusion site
+
+jobs:
+  build-docs:
+    name: Build docs
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout docs sources
+        uses: actions/checkout@v3
+
+      - name: Checkout docs target branch
+        uses: actions/checkout@v3
+        with:
+          repository: apache/arrow-site
+          path: docs-target
+
+      - name: Setup Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: "3.10"
+
+      - name: Install dependencies
+        run: |
+          set -x
+          python3 -m venv venv
+          source venv/bin/activate
+          pip install -r docs/requirements.txt
+
+      - name: Build docs
+        run: |
+          set -x
+          source venv/bin/activate
+          cd docs
+          ./build.sh
+
+      - name: Copy & push the generated HTML
+        run: |
+          set -x
+          cd docs-target/datafusion
+          cp -rT ../docs/build/html/* .
+          git status --porcelain
+          # if [ "$(git status --porcelain)" != "" ]; then
+          #   git config user.name "github-actions[bot]"
+          #   git config user.email "github-actions[bot]@users.noreply.github.com"
+          #   git add --all
+          #   git commit -m 'Publish built docs triggered by ${{ github.sha }}'
+          #   git push || git push --force
+          # fi