docs: add more notes to /prompts

Author: marcklingen

pages/docs/prompts.mdx

@@ -4,6 +4,25 @@ description: Manage and version your prompts in Langfuse (open source). When ret
 
 # Prompt Management
 
+Use Langfuse to effectively **manage** and **version** your prompts. Langfuse prompt management is basically a **Prompt CMS** (Content Management System).
+
+## How it works
+
+1. **Create/update** prompts via Langfuse API/SDKs or Console.
+2. **Use** prompts at runtime, always get the latest version (cached by Langfuse SDKs for low latency).
+3. _Optionally_, promote a specific version of a prompt to production or quickly rollback to a previous version.
+
+## Why use prompt management?
+
+Typical benefits of using a CMS apply here:
+
+- Decoupling: deploy new prompts without redeploying your application.
+- Non-technical users can create and update prompts via Langfuse Console.
+- Quickly rollback to a previous version of a prompt.
+- Link prompts to Langfuse Tracing to monitor their performance.
+
+## Get Started
+
 import { Terminal, FileCode } from "lucide-react";
 
 <Cards num={2}>

pages/docs/prompts/get-started.mdx

@@ -5,7 +5,7 @@ description: Manage and version your prompts in Langfuse (open source). When ret
 import { Callout } from "nextra-theme-docs";
 import { CloudflareVideo } from "@/components/Video";
 
-# Prompt Management
+# Get Started with Prompt Management
 
 Use Langfuse to effectively manage and version your prompts. This allows you to iterate quickly, publish new prompt versions without redeploying your app, and track metrics by prompt version.
 
@@ -73,13 +73,13 @@ const promptTemplate = PromptTemplate.fromTemplate(
 The workflow for managing prompts in Langfuse includes the following steps:
 
 ```mermaid
-graph LR
+graph TB
     A["1. Create new prompt version (SDK or UI)"] --> PV
     subgraph S1["Prompt (identified by name)"]
         PV["Prompt Version"] -->|"2. Promote"| PP["Production Prompt"]
     end
     PP --> D["3. Retrieve prompt using SDK"]
-    PP --> E["4. View metrics in Langfuse for prompt version"]
+    PP --> E["4. View metrics in Langfuse UI"]
 ```
 
 ## Prompt object