feat(docs): sync troubleshooting (#29933)

When a troubleshooting entry is created or updated in this repo, sync it to GitHub. This creates a new troubleshooting discussion if one does not exist, and updates the content on an existing troubleshooting discussion if it has changed.

To preserve the connections between GitHub discussions and Markdown files, record the discussion ID and URL to the database. The database ID is then written to the Markdown file, and a new PR is generated to commit the new Markdown with ID.

There is currently no mechanism to delete outdated discussions. That will be a follow-up.

.github/CODEOWNERS

@@ -3,6 +3,9 @@
 
 /apps/studio/ @supabase/Dashboard
 
+# temporary until we've ironed out all the problems with sync workflow
+/apps/docs/content/troubleshooting/ @charislam
+
 /apps/www/ @supabase/marketing
 /apps/www/public/images/blog @supabase/marketing
 /apps/www/lib/redirects.js

.github/workflows/docs-sync-troubleshooting.yml

@@ -0,0 +1,51 @@
+name: '[Docs] Sync troubleshooting guides to GitHub Discussions'
+
+on:
+  push:
+    branches:
+      - master
+    paths:
+      - 'apps/docs/content/troubleshooting/**'
+  workflow_dispatch:
+
+permissions:
+  contents: write
+  pull-requests: write
+
+jobs:
+  update-troubleshooting:
+    runs-on: ubuntu-latest
+
+    env:
+      SEARCH_GITHUB_APP_ID: ${{ secrets.SEARCH_GITHUB_APP_ID }}
+      SEARCH_GITHUB_APP_INSTALLATION_ID: ${{ secrets.SEARCH_GITHUB_APP_INSTALLATION_ID }}
+      SEARCH_GITHUB_APP_PRIVATE_KEY: ${{ secrets.SEARCH_GITHUB_APP_PRIVATE_KEY }}
+      NEXT_PUBLIC_SUPABASE_URL: ${{ secrets.SEARCH_SUPABASE_URL }}
+      SUPABASE_SECRET_KEY: ${{ secrets.SEARCH_SUPABASE_SERVICE_ROLE_KEY }}
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          sparse-checkout: |
+            apps/docs
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version-file: '.nvmrc'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run Troubleshooting script
+        run: npm --prefix=apps/docs run troubleshooting:sync
+
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@5e914681df9dc83aa4e4905692ca88beb2f9e91f # v7.0.5
+        with:
+          commit-message: '[bot] sync troubleshooting guides to db'
+          title: '[bot] sync troubleshooting guides to db'
+          author: 'github-docs-sync-bot <github-docs-sync-bot@supabase.com>'
+          branch: 'bot/docs-sync-troubleshooting'
+          branch-suffix: 'random'