From 38466eb7db8dcc4f6d6e5e135e6f319ea8450dae Mon Sep 17 00:00:00 2001
From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Date: Wed, 29 Apr 2026 15:24:33 +0000
Subject: [PATCH] feat: improve preview PR comment with branded design

Redesign the PR preview comment to be more visually appealing:
- Centered layout with Fern logo branding
- Clear status heading with checkmark
- Prominent, clickable preview link
- Collapsible 'Changed pages' section using <details>
- Subtle Fern branding footer

Co-Authored-By: ryanstep <ryanstep@umich.edu>
---
 .github/workflows/preview-docs.yml | 22 +++++++++++++++++++---
 1 file changed, 19 insertions(+), 3 deletions(-)

diff --git a/.github/workflows/preview-docs.yml b/.github/workflows/preview-docs.yml
index e4138a9..9c907f2 100644
--- a/.github/workflows/preview-docs.yml
+++ b/.github/workflows/preview-docs.yml
@@ -64,14 +64,30 @@ jobs:
 
       - name: Create comment content
         run: |
-          echo ":herb: **Preview your docs:** <${{ steps.generate-docs.outputs.preview_url }}>" > comment.md
-          
+          PREVIEW_URL="${{ steps.generate-docs.outputs.preview_url }}"
+          cat > comment.md << EOF
+          <div align="center">
+          <a href="https://buildwithfern.com"><img src="https://raw.githubusercontent.com/fern-api/docs-starter/main/fern/docs/assets/fern-logo-primary.svg" height="30" alt="Fern" /></a>
+          <h3>✅ Preview Ready</h3>
+          <strong><a href="$PREVIEW_URL">Visit Preview →</a></strong>
+          </div>
+
+          ---
+          EOF
+
           if [ -n "${{ steps.page-links.outputs.page_links }}" ]; then
             echo "" >> comment.md
-            echo "Here are the markdown pages you've updated:" >> comment.md
+            echo "<details>" >> comment.md
+            echo "<summary>📄 <strong>Changed pages</strong></summary>" >> comment.md
+            echo "" >> comment.md
             echo "${{ steps.page-links.outputs.page_links }}" >> comment.md
+            echo "" >> comment.md
+            echo "</details>" >> comment.md
+            echo "" >> comment.md
           fi
 
+          echo '<sub>🌿 Deployed with <a href="https://buildwithfern.com">Fern</a></sub>' >> comment.md
+
       - name: Post PR comment
         uses: thollander/actions-comment-pull-request@v2.4.3
         with: