More copy + diagram updates

D-K-P · D-K-P · commit 829eef2d7202 · 2025-10-29T14:55:36.000Z
diff --git a/docs/guides/use-cases/data-processing-etl.mdx b/docs/guides/use-cases/data-processing-etl.mdx
@@ -1,14 +1,14 @@
 ---
 title: "Data processing & ETL workflows"
 sidebarTitle: "Data processing & ETL"
-description: "Learn how to use Trigger.dev for data processing and ETL including web scraping, database synchronization, batch enrichment, and streaming analytics workflows"
+description: "Learn how to use Trigger.dev for data processing and ETL (Extract, Transform, Load), including web scraping, database synchronization, batch enrichment and more."
 ---
 
 import UseCasesCards from "/snippets/use-cases-cards.mdx";
 
 ## Overview
 
-Build data pipelines that process large datasets without timeouts. Handle streaming analytics, batch enrichment, web scraping, database sync, and file processing with automatic retries and progress tracking.
+Build complex data pipelines that process large datasets without timeouts. Handle streaming analytics, batch enrichment, web scraping, database sync, and file processing with automatic retries and progress tracking.
 
 ## Featured examples
 
@@ -24,23 +24,44 @@ Build data pipelines that process large datasets without timeouts. Handle stream
     Scrape websites using BrowserBase and Puppeteer.
   </Card>
   <Card
-    title="Supabase database operations"
+    title="Supabase database webhooks"
     icon="book"
-    href="/guides/examples/supabase-database-operations"
+    href="/guides/frameworks/supabase-edge-functions-database-webhooks"
   >
-    Run CRUD operations on Supabase database tables.
+    Trigger tasks from Supabase database webhooks.
   </Card>
 </CardGroup>
 
-## Why Trigger.dev for data processing
+## Benefits of using Trigger.dev for data processing & ETL workflows
 
 **Process datasets for hours without timeouts:** Handle multi-hour transformations, large file processing, or complete database exports. No execution time limits.
 
 **Parallel processing with built-in rate limiting:** Process thousands of records simultaneously while respecting API rate limits. Scale efficiently without overwhelming downstream services.
 
 **Stream progress to your users in real-time:** Show row-by-row processing status updating live in your dashboard. Users see exactly where processing is and how long remains.
 
-## Example workflows
+## Production use cases
+
+<CardGroup cols={1}>
+  <Card title="MagicSchool AI customer story" href="https://trigger.dev/customers/magicschool-ai-customer-story">
+
+Read how MagicSchool AI uses Trigger.dev to generate insights from millions of student interactions.
+
+</Card>
+
+<Card title="Comp AI customer story" href="https://trigger.dev/customers/comp-ai-customer-story">
+
+Read how Comp AI uses Trigger.dev to automate evidence collection at scale, powering their open source, AI-driven compliance platform.
+
+</Card>
+<Card title="Midday customer story" href="https://trigger.dev/customers/midday-customer-story">
+
+Read how Midday use Trigger.dev to sync large volumes of bank transactions in their financial management platform.
+
+</Card>
+</CardGroup>
+
+## Example worfklow patterns
 
 <Tabs>
   <Tab title="CSV import">
diff --git a/docs/guides/use-cases/marketing.mdx b/docs/guides/use-cases/marketing.mdx
@@ -8,7 +8,7 @@ import UseCasesCards from "/snippets/use-cases-cards.mdx";
 
 ## Overview
 
-Build marketing workflows from drip campaigns to real-time personalization. Handle multi-day sequences, behavioral triggers, dynamic content generation, and live analytics, all with automatic retries and progress tracking.
+Build marketing workflows from drip campaigns to orchestrating multi-channel campaigns. Handle multi-day sequences, behavioral triggers, dynamic content generation, and live analytics, all with automatic retries and progress tracking.
 
 ## Featured examples
 
@@ -25,18 +25,18 @@ Build marketing workflows from drip campaigns to real-time personalization. Hand
     icon="book"
     href="/guides/example-projects/product-image-generator"
   >
-    Transform product photos into professional marketing images with AI.
+    Transform product photos into professional marketing images using Replicate.
   </Card>
   <Card
     title="Human-in-the-loop workflow"
     icon="book"
     href="/guides/example-projects/human-in-the-loop-workflow"
   >
-    Add approval gates to workflows using waitpoint tokens.
+    Approve marketing content using a human-in-the-loop workflow.
   </Card>
 </CardGroup>
 
-## Why Trigger.dev for marketing
+## Benefits of using Trigger.dev for marketing workflows
 
 **Delays without idle costs:** Wait hours or weeks between steps. Pay only for active compute, not wait time. Perfect for drip campaigns and scheduled follow-ups.
 
@@ -46,25 +46,16 @@ Build marketing workflows from drip campaigns to real-time personalization. Hand
 
 ## Production use cases
 
-<CardGroup cols={2}>
-  <Card title="[Customer/Company Name]" icon="building">
-    [1-2 sentence description of what they built and the impact/result]
-  </Card>
-  <Card title="[Customer/Company Name]" icon="building">
-    [1-2 sentence description of what they built and the impact/result]
-  </Card>
-  <Card title="[Customer/Company Name]" icon="building">
-    [1-2 sentence description of what they built and the impact/result]
-  </Card>
-  <Card title="[Customer/Company Name]" icon="building">
-    [1-2 sentence description of what they built and the impact/result]
-  </Card>
-</CardGroup>
+  <Card title="Icon customer story" href="https://trigger.dev/customers/icon-customer-story">
+
+Read how Icon uses Trigger.dev to process and generate thousands of videos per month for their AI-driven video creation platform.
+
+</Card>
 
-## Example workflows
+## Example worfklow patterns
 
 <Tabs>
-  <Tab title="Email sequence">
+  <Tab title="Drip email campaign">
     Simple drip campaign. User signs up, waits specified delay, sends personalized email, tracks engagement.
 
 <div align="center">
diff --git a/docs/guides/use-cases/media-generation.mdx b/docs/guides/use-cases/media-generation.mdx
@@ -1,6 +1,6 @@
 ---
-title: "AI-powered media generation workflows"
-sidebarTitle: "AI-powered media generation"
+title: "AI media generation workflows"
+sidebarTitle: "AI media generation"
 description: "Learn how to use Trigger.dev for AI media generation including image creation, video synthesis, audio generation, and multi-modal content workflows"
 ---
 
@@ -13,9 +13,6 @@ Build AI media generation pipelines that handle unpredictable API latencies and
 ## Featured examples
 
 <CardGroup cols={3}>
-  <Card title="DALL·E 3" icon="book" href="/guides/examples/dall-e3-generate-image">
-    Generate images from text prompts using OpenAI's DALL·E 3.
-  </Card>
   <Card
     title="Product image generator"
     icon="book"
@@ -30,17 +27,41 @@ Build AI media generation pipelines that handle unpredictable API latencies and
   >
     Generate memes with DALL·E 3 and add human approval steps.
   </Card>
+  <Card
+    title="Vercel AI SDK image generation"
+    icon="book"
+    href="/guides/example-projects/vercel-ai-sdk-image-generator"
+  >
+    Generate images from text prompts using the Vercel AI SDK.
+  </Card>
 </CardGroup>
 
-## Why Trigger.dev for AI media generation
+## Benefits of using Trigger.dev for AI media generation workflows
 
 **Pay only for active compute, not AI inference time:** Checkpoint-resume pauses during AI API calls. Generate content that takes minutes or hours without paying for idle inference time.
 
 **No timeout limits for long generations:** Handle generations that take minutes or hours without execution limits. Perfect for high-quality video synthesis and complex multi-modal workflows.
 
 **Human approval gates for brand safety:** Add review steps before publishing AI-generated content. Pause workflows for human approval using waitpoint tokens.
 
-## Example workflows
+## Production use cases
+
+<CardGroup cols={1}>
+
+  <Card title="Icon customer story" href="https://trigger.dev/customers/icon-customer-story">
+
+Read how Icon uses Trigger.dev to process and generate thousands of videos per month for their AI-driven video creation platform.
+
+</Card>
+
+<Card title="Papermark customer story" href="https://trigger.dev/customers/papermark-customer-story">
+
+Read how Papermark process thousands of documents per month using Trigger.dev.
+
+</Card>
+</CardGroup>
+
+## Example worfklow patterns
 
 <Tabs>
   <Tab title="Image generation">
@@ -50,10 +71,9 @@ Build AI media generation pipelines that handle unpredictable API latencies and
 
 ```mermaid
 graph TB
-    A[generateImage] --> B[callDALLE3]
-    B --> C[optimizeImage]
-    C --> D[uploadToStorage]
-    D --> E[updateDatabase]
+    A[generateImage] --> B[optimizeImage]
+    B --> C[uploadToStorage]
+    C --> D[updateDatabase]
 ```
 
 </div>
diff --git a/docs/guides/use-cases/media-processing.mdx b/docs/guides/use-cases/media-processing.mdx
@@ -1,7 +1,7 @@
 ---
 title: "Media processing workflows"
 sidebarTitle: "Media processing"
-description: "Learn how to use Trigger.dev for media processing including video transcoding, image optimization, audio transformation, and document conversion workflows"
+description: "Learn how to use Trigger.dev for media processing including video transcoding, image optimization, audio transformation, and document conversion."
 ---
 
 import UseCasesCards from "/snippets/use-cases-cards.mdx";
@@ -17,11 +17,11 @@ Build media processing pipelines that handle large files and long-running operat
     Process videos and upload results to R2 storage using FFmpeg.
   </Card>
   <Card
-    title="Deepgram audio transcription"
+    title="Product image generator"
     icon="book"
-    href="/guides/examples/deepgram-transcribe-audio"
+    href="/guides/example-projects/product-image-generator"
   >
-    Transcribe audio files using Deepgram's speech recognition API.
+    Transform product photos into professional marketing images using Replicate.
   </Card>
   <Card
     title="LibreOffice PDF conversion"
@@ -32,15 +32,15 @@ Build media processing pipelines that handle large files and long-running operat
   </Card>
 </CardGroup>
 
-## Why Trigger.dev for media processing
+## Benefits of using Trigger.dev for media processing workflows
 
 **Process multi-hour videos without timeouts:** Transcode videos, extract frames, or run CPU-intensive operations for hours. No execution time limits.
 
 **Stream progress to users in real-time:** Show processing status updating live in your UI. Users see exactly where encoding is and how long remains.
 
 **Parallel processing with resource control:** Process hundreds of files simultaneously with configurable concurrency limits. Control resource usage without overwhelming infrastructure.
 
-## Example workflows
+## Example worfklow patterns
 
 <Tabs>
   <Tab title="Video transcode">
@@ -60,7 +60,7 @@ graph TB
 </div>
   </Tab>
 
-  <Tab title="Adaptive pipeline">
+  <Tab title="Adaptive video processing">
     **Router + Coordinator pattern**. Analyzes video metadata to determine source resolution, routes to appropriate transcoding preset, batch triggers parallel post-processing for thumbnails, preview clips, and chapter detection.
 
 <div align="center">
@@ -93,7 +93,7 @@ graph TB
 </div>
   </Tab>
 
-  <Tab title="Smart images">
+  <Tab title="Smart image optimization">
     **Router + Coordinator pattern**. Analyzes image content to detect type, routes to specialized processing (background removal for products, face detection for portraits, scene analysis for landscapes), upscales with AI, batch triggers parallel variant generation.
 
 <div align="center">
@@ -149,7 +149,7 @@ graph TB
 </div>
   </Tab>
 
-  <Tab title="Document processing">
+  <Tab title="Document extraction with approval">
     **Router pattern with human-in-the-loop**. Detects file type and routes to appropriate processor, classifies document with AI to determine type (invoice/contract/receipt), extracts structured data fields, optionally pauses with wait.for for human approval.
 
 <div align="center">
diff --git a/docs/snippets/use-cases-cards.mdx b/docs/snippets/use-cases-cards.mdx
@@ -1,46 +1,24 @@
-## Use cases
+## Featured use cases
 
 <CardGroup cols={2}>
   <Card
-    title="AI agents & automation"
-    href="https://trigger.dev/docs/guides/use-cases/ai-platforms"
+    title="Data processing & ETL workflows"
+    icon="database"
+    href="/guides/use-cases/data-processing-etl"
   >
-    Build intelligent workflows that combine AI processing with human oversight. From research
-    agents to customer support systems and content moderation pipelines.
+    Build complex data pipelines that process large datasets without timeouts.
   </Card>
-  <Card
-    title="Data Processing & ETL"
-    href="https://trigger.dev/docs/guides/use-cases/data-processing-etl"
-  >
-    Transform and move data reliably at any scale. Whether streaming real-time analytics, enriching
-    customer records, or synchronizing large datasets.
-  </Card>
-  <Card
-    title="Content generation"
-    href="https://trigger.dev/docs/guides/use-cases/content-generation"
-  >
-    Create scalable content workflows from single assets to thousands. Generate PDFs, videos, or
-    social media content with progress tracking and approval steps.
+  <Card title="Media processing workflows" icon="film" href="/guides/use-cases/media-processing">
+    Batch process videos, images, audio, and documents with no execution time limits.
   </Card>
   <Card
-    title="AI-powered media generation"
-    href="https://trigger.dev/docs/guides/use-cases/media-generation"
+    title="AI media generation workflows"
+    icon="wand-magic-sparkles"
+    href="/guides/use-cases/media-generation"
   >
-    Generate images, videos, and audio with AI models. Handle unpredictable API latencies,
-    manage rate limits, and stream progress in real-time.
+    Generate images, videos, audio, documents and other media using AI models.
   </Card>
-  <Card
-    title="Media processing"
-    href="https://trigger.dev/docs/guides/use-cases/media-processing"
-  >
-    Process audio, video, and images efficiently with adaptive workflows. From real-time
-    transcription to batch optimization.
-  </Card>
-  <Card
-    title="Marketing"
-    href="https://trigger.dev/docs/guides/use-cases/marketing"
-  >
-    Orchestrate campaigns that respond dynamically to user behavior. Build drip sequences,
-    personalization engines, and analytics workflows.
+  <Card title="Marketing workflows" icon="bullhorn" href="/guides/use-cases/marketing">
+    Build drip campaigns, create marketing content, and orchestrate multi-channel campaigns.
   </Card>
 </CardGroup>
