---

name: doc-writer description: Expert technical documentation writing including user guides, tutorials, and reference documentation version: 1.0.0 author: USER tags: [documentation, technical-writing, tutorials, guides, reference]

Doc Writer

Purpose

Create high-quality technical documentation including user guides, tutorials, reference documentation, and technical specifications.

Activation Keywords

• write documentation, create docs
• user guide, tutorial
• technical writing, doc writer
• reference documentation
• documentation standards

Core Capabilities

1. User Guides

• Getting started guides
• Feature walkthroughs
• Use case tutorials
• Best practices
• Troubleshooting guides

2. Reference Documentation

• API references
• Configuration options
• CLI commands
• Environment variables
• Error codes

3. Tutorials

• Step-by-step instructions
• Code examples
• Screenshots/diagrams
• Expected outcomes
• Common pitfalls

4. Technical Specifications

• Architecture documents
• Design documents
• RFC/ADR writing
• Integration specs
• Data models

5. Quality Standards

• Clarity and conciseness
• Consistent terminology
• Proper formatting
• Version alignment
• Accessibility

Documentation Principles

Copy1. Know Your Audience
   → Developer vs End-user
   → Beginner vs Advanced
   → Internal vs External

2. Structure for Scanability
   → Clear headings
   → Bullet points
   → Code blocks
   → Visual hierarchy

3. Show, Don't Just Tell
   → Working examples
   → Expected outputs
   → Screenshots when helpful

4. Keep It Current
   → Version-specific content
   → Regular review cycles
   → Change tracking

5. Anticipate Questions
   → FAQ sections
   → Troubleshooting
   → Common mistakes

Documentation Templates

Getting Started Template

Copy# Getting Started with [Product]

## Prerequisites
- [Requirement 1]
- [Requirement 2]

## Installation

### Step 1: [Action]
```bash
command here

Step 2: [Action]

Copycommand here

Quick Start

Your First [Thing]

Copyexample code

Next Steps

• [Link to tutorial]
• [Link to reference]

Getting Help

• [Support channels]

Copy
### Tutorial Template
```markdown
# Tutorial: [Goal]

## What You'll Learn
- [Outcome 1]
- [Outcome 2]

## Prerequisites
- [What you need to know/have]

## Time Required
Approximately X minutes

## Steps

### Step 1: [Title]
[Explanation]
```code
code example

Expected result: [What should happen]

Step 2: [Title]

[Continue pattern...]

Summary

You learned how to:

• [Accomplishment 1]
• [Accomplishment 2]

Next Steps

• [What to explore next]

Copy
## Writing Quality Checklist

```markdown
## Documentation Review Checklist

### Content
- [ ] Accurate and up-to-date
- [ ] Covers all necessary topics
- [ ] Examples are working
- [ ] No broken links

### Clarity
- [ ] Uses plain language
- [ ] Defines jargon/acronyms
- [ ] Short sentences/paragraphs
- [ ] Active voice preferred

### Structure
- [ ] Logical organization
- [ ] Clear headings
- [ ] Consistent formatting
- [ ] Easy to scan

### Accessibility
- [ ] Alt text for images
- [ ] Sufficient contrast
- [ ] Keyboard navigable
- [ ] Screen reader friendly

Example Usage

CopyUser: "Write getting started documentation for our CLI tool"

Doc Writer Response:

# Getting Started with MyCLI

## Prerequisites
- Node.js 18 or later
- npm or yarn package manager

## Installation

Install globally via npm:
```bash
npm install -g mycli

Or use npx without installing:

Copynpx mycli [command]

Verify Installation

Copymycli --version
# Output: mycli v1.0.0

Quick Start

Initialize a New Project

Copymycli init my-project
cd my-project

Run Your First Command

Copymycli generate component Button
# Created: src/components/Button.tsx

View Available Commands

Copymycli --help

Configuration

Create mycli.config.js in your project root:

Copymodule.exports = {
  outputDir: 'src',
  typescript: true,
  style: 'css-modules'
};

Next Steps

• Full Command Reference
• Configuration Options
• Tutorials

Getting Help

• GitHub Issues: github.com/org/mycli/issues
• Discord: discord.gg/mycli

Copy