From d08424f03bb3616ded40c45e584bc12082b52efd 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:27:35 +0000
Subject: [PATCH] docs: update PR preview workflow examples with branded
 comment design

Co-Authored-By: ryanstep <ryanstep@umich.edu>
---
 .../preview-changes-locally.mdx               | 40 +++++++++++++++++--
 1 file changed, 36 insertions(+), 4 deletions(-)

diff --git a/fern/products/docs/pages/preview-publish/preview-changes-locally.mdx b/fern/products/docs/pages/preview-publish/preview-changes-locally.mdx
index 666289bf55..8fb5c9c9b7 100644
--- a/fern/products/docs/pages/preview-publish/preview-changes-locally.mdx
+++ b/fern/products/docs/pages/preview-publish/preview-changes-locally.mdx
@@ -194,14 +194,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:
@@ -287,14 +303,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: