Merge branch 'main' into devin/1773760543-og-text-color-docs

Author: devin-ai-integration[bot]

.claude/skills/changelog/SKILL.md

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Find and merge dependent PRs
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           script: |
             const version = context.payload.client_payload.version;

.claude/skills/links/SKILL.md

@@ -13,7 +13,7 @@ jobs:
     if: ${{ github.event.pull_request.user.login == 'devin-ai-integration[bot]' }}
     steps:
       - name: Auto-assign requester from PR description
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           script: |

.github/workflows/auto-merge-on-docs-release.yml

@@ -16,7 +16,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Create lychee config
         run: |
@@ -32,6 +32,12 @@ jobs:
 
           # Exclude patterns (regex)
           exclude = [
+            # Malformed ToC anchor links generated by the docs platform
+            # These contain internal routing params (domain/host/auth/audience/version/path)
+            # and are not real broken links — this is a fern-platform rendering bug
+            "buildwithfern\\.com/_/buildwithfern\\.com/",
+            "app\\.buildwithfern\\.com/buildwithfern\\.com/",
+            
             # Placeholder/example URLs
             "^https://example\\.com",
             "^https://github\\.com/owner/repo",
@@ -41,6 +47,10 @@ jobs:
             "^https://c\\.vialoops\\.com",
             "_vercel/(speed-)?insights",
             
+            # Next.js image optimization URLs with content hashes that go stale after each deployment
+            # These are generated by the platform (not source-level links) and resolve after redeployment
+            "buildwithfern\\.com/_next/image",
+            
             # Asset URLs that work on the live site but are not directly accessible
             "buildwithfern\\.com/learn/dashboard/assets/pdf-ui\\.png",
             
@@ -64,9 +74,6 @@ jobs:
             "^tel:",
             "^javascript:",
             
-            # Anchor-only links
-            "^#",
-            
             # All GitHub URLs - checked separately in dedicated steps
             "^https://github\\.com/"
           ]
@@ -326,7 +333,7 @@ jobs:
 
 
       - name: Upload URLs (early, for debugging)
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         with:
           name: urls
           path: |
@@ -363,6 +370,7 @@ jobs:
             --max-retries 3
             --retry-wait-time 10
             --max-concurrency 20
+            --include-fragments
             --files-from urls.txt
           output: ./lychee-raw-main.md
           format: markdown
@@ -504,6 +512,11 @@ jobs:
             url=$(echo "$line" | sed -E 's/.*<([^>]+)>.*/\1/')
             status=$(echo "$line" | sed -E 's/.*\[([0-9]+)\].*/\1/')
             
+            # Skip malformed ToC anchor links (fern-platform rendering bug)
+            if echo "$url" | grep -qE 'buildwithfern\.com/_/buildwithfern\.com/|app\.buildwithfern\.com/buildwithfern\.com/'; then
+              continue
+            fi
+            
             # Check if this is a repo-internal GitHub URL (blob/main pattern)
             if echo "$url" | grep -qE '^https://github\.com/fern-api/docs/blob/main/'; then
               # Extract relative path from URL (strip prefix and query string)
@@ -706,15 +719,15 @@ jobs:
 
       - name: Upload errors-only report
         if: always()
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         with:
           name: lychee-report
           path: ./lychee-report.md
           if-no-files-found: ignore
 
       - name: Upload lychee outputs and verification results
         if: always()
-        uses: actions/upload-artifact@v4
+        uses: actions/upload-artifact@v6
         with:
           name: lychee-outputs
           path: |
@@ -727,7 +740,7 @@ jobs:
       - name: Create PR for broken links
         id: create-pr
         if: steps.check_failures.outputs.has_other_failures == 'true' || steps.retry429.outputs.has_429_failures == 'true' || steps.verify_github.outputs.has_missing == 'true'
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         env:
           DEVIN_PROMPT: |
             @devin-ai-integration Please fix the broken links detected by the scheduled link checker.
@@ -816,6 +829,15 @@ jobs:
             scaffoldContent += '\n---\n';
             scaffoldContent += `[View workflow run](https://github.com/${owner}/${repo}/actions/runs/${context.runId})\n`;
 
+            // Truncate PR body to stay under GitHub's 65536 character limit
+            // The full content is still written to the scaffold file
+            const MAX_PR_BODY_LENGTH = 60000; // leave headroom for safety
+            let prBody = scaffoldContent;
+            if (prBody.length > MAX_PR_BODY_LENGTH) {
+              const truncationNote = `\n\n---\n⚠️ **Report truncated** — full list is in the scaffold file (\`${filePath}\`) on the branch.\n[View workflow run](https://github.com/${owner}/${repo}/actions/runs/${context.runId})\n`;
+              prBody = prBody.substring(0, MAX_PR_BODY_LENGTH - truncationNote.length) + truncationNote;
+            }
+
             // Get the base branch ref
             const baseRef = await github.rest.git.getRef({
               owner,
@@ -953,7 +975,7 @@ jobs:
                 title: 'Fix broken links (Devin)',
                 head: branchName,
                 base: baseBranch,
-                body: scaffoldContent,
+                body: prBody,
                 draft: true,
               });
 
@@ -968,7 +990,7 @@ jobs:
 
       - name: Send Slack notification for broken links
         if: steps.create-pr.outputs.pr_created == 'true'
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         env:
           SLACK_TOKEN: ${{ secrets.DEVIN_AI_PR_BOT_SLACK_TOKEN }}
           PR_URL: ${{ steps.create-pr.outputs.pr_url }}

.github/workflows/check-devin-pr-assignee.yml

@@ -16,12 +16,12 @@ jobs:
 
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
 
       - name: Setup Node.js
-        uses: actions/setup-node@v4
+        uses: actions/setup-node@v5
         with:
           node-version: '20'
           cache: 'npm'
@@ -62,7 +62,7 @@ jobs:
 
       - name: Comment on issue
         if: success()
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           script: |
             github.rest.issues.createComment({
@@ -74,7 +74,7 @@ jobs:
 
       - name: Comment on failure
         if: failure()
-        uses: actions/github-script@v7
+        uses: actions/github-script@v8
         with:
           script: |
             github.rest.issues.createComment({

.github/workflows/check-links.yml

@@ -14,7 +14,7 @@ jobs:
       contents: read # For checking out code
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
         with:
           fetch-depth: 0  # Fetch full history for git diff
 
@@ -30,8 +30,9 @@ jobs:
         id: generate-docs
         env:
           FERN_TOKEN: ${{ secrets.FERN_TOKEN }}
+          HEAD_REF: ${{ github.head_ref }}
         run: |
-          OUTPUT=$(fern generate --docs --preview --instance fern-api.docs.buildwithfern.com/learn 2>&1) || true
+          OUTPUT=$(fern generate --docs --preview --id "$HEAD_REF" --instance fern-api.docs.buildwithfern.com/learn 2>&1) || true
           echo "$OUTPUT"
           URL=$(echo "$OUTPUT" | grep -oP 'Published docs to \K.*(?= \()')
           echo "preview_url=$URL" >> $GITHUB_OUTPUT

.github/workflows/fern-scribe.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
-        uses: actions/checkout@v4
+        uses: actions/checkout@v5
 
       - name: Setup Fern CLI
         uses: fern-api/setup-fern-cli@v1

.github/workflows/preview-docs.yml

@@ -9,7 +9,7 @@ jobs:
   update-versions:
     runs-on: ubuntu-latest
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
         with:
           ref: main
       - name: update-csharp-version
@@ -36,7 +36,7 @@ jobs:
         run: curl -s https://api.github.com/repos/fern-api/fern/releases/latest | jq -r -j '.tag_name' > fern/snippets/version-number-cli.mdx
       - name: create PR
         id: cpr
-        uses: peter-evans/create-pull-request@v7
+        uses: peter-evans/create-pull-request@v8
         with:
           commit-message: "update versions from docker hub"
           title: "Update versions from docker hub"
@@ -52,7 +52,7 @@ jobs:
       - name: Approving PR
         if: steps.cpr.outputs.pull-request-operation == 'created'
         env:
-          GH_TOKEN: ${{ secrets.PR_BOT_GH_PAT }}
+          GH_TOKEN: ${{ secrets.FERN_GITHUB_TOKEN }}
         run: |
           echo "Approving PR"
-          gh pr review ${{ steps.cpr.outputs.pull-request-number }} --approve
+          gh pr review ${{ steps.cpr.outputs.pull-request-number }} --approve

.github/workflows/publish-docs.yml

@@ -15,11 +15,11 @@ jobs:
       github.event.pull_request.user.login != 'fern-support' &&
       github.event.pull_request.user.login != 'github-actions'
     steps:
-      - uses: actions/checkout@v4
+      - uses: actions/checkout@v5
 
       - name: Get changed files
         id: changed-files
-        uses: tj-actions/changed-files@v41
+        uses: tj-actions/changed-files@v47
         with:
           files: |
             fern/**/*.md