Technical Writing Portfolio
I create clear, user-friendly documentation and educational content for technical products and AI systems. Below are samples demonstrating my approach to help center articles, product communications, and user support content.
Sample 1: Help Center Article - "How to Get Better Responses from Claude"
This sample demonstrates my ability to create structured, accessible help center content that guides users through best practices:
How to Get Better Responses from Claude
Getting useful, accurate responses from Claude starts with how you frame your questions. These strategies will help you communicate more effectively and get better results.
Be Specific About What You Need
The more precise your request, the more targeted Claude's response will be. Instead of broad questions, provide clear context about your goal.
Example:
❌ Less effective: "Help me write something"
✅ More effective: "I'm writing a cover letter for a technical writing position at an AI company. Can you help me make my opening paragraph more engaging?"
Why this works: Specific requests give Claude the context needed to provide relevant, actionable guidance.
Break Complex Tasks Into Steps
For complicated projects, tackle one component at a time rather than asking Claude to handle everything at once.
How to do this:
Write out your overall goal
Identify the individual steps needed
Work through each step in sequence with Claude
Reference earlier responses to build on previous work
Why this works: Breaking tasks down improves accuracy and lets you guide the direction as you progress.
Keep Your Prompts Clear and Direct
You don't need to overthink how you phrase questions. Clear, straightforward language works best.
Tips:
State what you want directly
Avoid unnecessary politeness (Claude doesn't require it)
Focus on the task, not on how you're asking
Why this works: Simple, direct prompts help Claude understand exactly what you're looking for without ambiguity.
Take a Moment Between Responses
After Claude responds, read through the answer carefully before moving forward.
Best practice:
Review what Claude provided
Consider if it fully addresses your need
Formulate your next question based on what's helpful (or what's missing)
Why this works: Thoughtful follow-up questions lead to more productive conversations.
Start With a Clear Goal
Before beginning a conversation, identify what you want to accomplish. Having a specific objective helps you get more useful results.
Example:
Goal: "I need to understand how to structure a project proposal"
Not a goal: "Tell me about project management"
Why this works: Clear intentions lead to focused, relevant responses that actually help you complete your task.
Ask for Revisions When Needed
If Claude's response isn't quite right, don't hesitate to ask for adjustments. You can request:
Different tone or style
More or less detail
Alternative approaches
Specific changes to what was provided
Why this works: Iteration is normal and helps you arrive at exactly what you need.
Still need help? Visit our Support Center or contact our team.
__________
Skills demonstrated:
- Structuring content to facilitate scanning (clear headers, bullets, examples)
- Explaining technical concepts in accessible language
- Anticipating user questions and providing actionable guidance
- Writing in a supportive, professional tone appropriate for product documentation
- Applying product knowledge (extensive experience using Claude)
______________________
Sample 2: Customer Incident Communication
This sample shows my approach to transparent, timely customer communication during service disruptions.
Service Disruption - Los Angeles Region Resolved
What happened
Between 9:00 AM and 11:00 AM PT today, approximately 100,000 users in the Los Angeles area could not log into the platform. Users who were already logged in were not affected.
Current status
The issue is fully resolved as of 11:00 AM PT. All systems are operating normally.
What caused this
We're conducting a root cause investigation to understand why this happened and prevent it from occurring again. We'll share our findings within one week.
We're sorry
We know how disruptive service outages are, especially during work hours. We're taking this seriously and working to ensure it doesn't happen again.
Questions? Our support team is here to help: [contact link]
__________
Skills demonstrated:
- Clear communication during service disruptions
- Balancing technical detail with user empathy
- Prioritizing critical information (impact, resolution, timeline)
- Maintaining user trust through transparency
- Efficient, scannable structure
_____________________
Sample 3: Product Release Communication
- Game Patch Notes This sample demonstrates my ability to translate technical product changes into user-friendly release documentation.
Patch 2.4.1 | Released January 15, 2025 | PC/Console
Update on Recent Combat Balance Improvements
Today’s update focuses on improving combat balance and addressing several high-impact issues reported since the last release. While this patch resolves the majority of known problems, we’re continuing to investigate one issue that will be addressed in an upcoming update.
Combat Balance Changes
Reduced Tyrfing sword damage output (DPS) by 15% to bring performance in line with intended balance
· Why this change: Tyrfing was dominating encounters, creating frustration for players without access to this weapon
Reduced healing spell availability in the Arctic Plain by approximately 50%.
· Why this change: Combined with Tyrfing adjustments, this increases the challenge of reaching high-level content while maintaining game balance
Increased Erymanthian Boar movement speed by 20% and HP by 500 points
· Why this change: Capture attempts were succeeding at higher rates than intended for this legendary creature
Bug Fixes
Fixed performance issues causing lag during quest objective completion
Resolved NPC behavior issue in Forest of Avalon where characters would unexpectedly fall through terrain
Fixed collision detection at Miller's Crossing pub, preventing players from passing through walls
Known Issues
Extended loading times when entering Forest of Avalon (fix scheduled for next patch)
___________
Skills demonstrated:
- Translating technical changes into user benefits
- Organizing information by priority and category
- Connecting system changes to user experience
- Setting expectations for known issues and future updates
- Balancing technical accuracy with accessibility