ci(docs): revalidate docs site pages when docs are changed

Author: charislam

.github/workflows/docs.yml

@@ -0,0 +1,25 @@
+name: Deploy docs
+
+on:
+  push:
+    branches:
+      - main
+      # testing only
+      - ci/docs-revalidation
+    # paths:
+      # - "docs/**"
+
+permissions: {}
+
+jobs:
+  deploy-docs:
+    runs-on: ubuntu-latest
+    env:
+      DOCS_REVALIDATION_KEY: ${{ secrets.DOCS_REVALIDATION_KEY }}
+    steps:
+      - name: Request docs revalidation
+        run: |
+          curl -X POST https://supabase.com/docs/api/revalidate \
+            -H 'Content-Type: application/json' \
+            -H 'Authorization: Bearer ${{ secrets.DOCS_REVALIDATION_KEY }}' \
+            -d '{"tags": ["graphql"]}'