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:

  1. Write out your overall goal

  2. Identify the individual steps needed

  3. Work through each step in sequence with Claude

  4. 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