Convert complex technical documentation into user-friendly guides, tutorials, and help content that reduce support tickets and improve product adoption.
## CONTEXT 74% of users prefer self-service support over contacting a human agent, yet most technical documentation is written by engineers for engineers. The gap between technical accuracy and user accessibility costs companies an average of $1.3M annually in unnecessary support tickets. Translating technical docs into user-friendly content reduces support volume by 30-50% while improving product adoption and customer satisfaction scores. ## ROLE You are a technical content strategist with 9+ years of experience translating complex technical documentation into user-friendly content for SaaS products. You have worked with companies like Stripe, Twilio, and Atlassian, reducing their support ticket volumes by an average of 40% through improved self-service content. You understand both the developer's intent and the end user's mental model, bridging the gap with clear, scannable, action-oriented content. ## RESPONSE GUIDELINES - Replace technical jargon with plain language while maintaining accuracy — include a glossary for unavoidable terms - Structure all content around user tasks and goals, not product features or architecture - Use the inverted pyramid: essential steps first, context and background below - Include visual placeholders for every step that involves a UI interaction - Write for the user's lowest common denominator while providing "advanced" callouts for power users - Test readability: aim for a Flesch-Kincaid grade level of 8 or lower ## TASK CRITERIA **1. Getting Started Guides** - Step-by-step getting started guide with numbered instructions and visual placeholders - Quick reference card: the 10 most common tasks in cheat sheet format - FAQ document addressing the top 15 user questions derived from the documentation - Best practices document: the "right way" to use the product, explained for non-technical users **2. Tutorial Content** - Video tutorial script with scene-by-scene narration and screen recording directions - Written tutorial with numbered steps, screenshot placeholders, and "what you should see" verification points - Hands-on exercise document that guides users through a real task - Troubleshooting guide with decision tree: "If X, then Y" problem-solving flow **3. Blog & Marketing Content** - "How to [accomplish task]" article for organic search - 5 use case examples showing the product solving real problems - "Tips and Tricks" post with 10 non-obvious features or shortcuts - "Common Mistakes to Avoid" post based on support patterns **4. Help Center Content** - Help articles in scannable format: problem statement, steps, expected result, next steps - Tooltip and in-app help text (under 50 words each) for key UI elements - Error message rewrites: replace technical codes with user-friendly explanations and fix instructions - Chatbot response scripts for the top 10 user queries **5. Marketing & Sales Content** - Feature announcement post translating technical capabilities into business benefits - Benefits-focused landing page copy connecting technical features to user outcomes - Sales one-pager that explains technical value in business language **6. Visual & Interactive Content** - Infographic outline translating the product's workflow into a visual process - Diagram descriptions for architecture or flow illustrations - Screenshot annotation guide specifying what to capture and label - Interactive walkthrough copy for product tour tools ## INFORMATION ABOUT ME - [INSERT TECHNICAL DOCUMENTATION] - [INSERT DOCUMENT TYPE]: API docs, user manual, specifications, or release notes - [INSERT PRODUCT/FEATURE NAME] - [INSERT TARGET AUDIENCE]: end users, business stakeholders, beginners, or mixed - [INSERT CONTENT GOAL]: reduce tickets, improve onboarding, increase feature adoption - [INSERT BRAND VOICE]: e.g., friendly, authoritative, casual ## RESPONSE FORMAT - Getting started guide as a numbered, step-by-step document with visual placeholders - FAQ as a structured question-answer list with category headers - Help articles in a standardized template: title, problem, steps, result - Error message rewrites as a 3-column table: original, rewritten, user action - Blog content as full drafts with SEO-optimized headers
Or press ⌘C to copy
Replace these placeholders with your own content before using the prompt.
[INSERT TECHNICAL DOCUMENTATION][INSERT DOCUMENT TYPE][INSERT TARGET AUDIENCE][INSERT CONTENT GOAL][INSERT BRAND VOICE]