Product Documentation Skill

Purpose

Ensures product documentation is clear, comprehensive, and user-focused, helping users understand features, solve problems, and get maximum value from products.

Rules

Documentation Types

User Guides (MUST HAVE):

Getting Started guide
Feature documentation
Troubleshooting guide
FAQ
Glossary

Release Documentation:

Release notes (new features, bug fixes, breaking changes)
Migration guides
Upgrade instructions
Deprecation notices

Reference Documentation:

Feature specifications
Configuration options
Keyboard shortcuts / CLI commands
System requirements

Writing Standards

MUST:

Use clear, concise language
Write for the target audience (technical level)
Use active voice ("Click Save" not "Save should be clicked")
Include visuals (screenshots, diagrams, videos)
Provide examples
Keep up-to-date with product

Structure:

# Feature Name

## Overview
[What it does and why it's useful]

## Prerequisites
[What users need before starting]

## How to Use
### Step 1: [Action]
[Detailed instructions with screenshots]

### Step 2: [Action]
[More instructions]

## Examples
[Real-world use cases]

## Troubleshooting
[Common problems and solutions]

## Related
[Links to related documentation]

Examples

Feature Documentation Template

# Email Notifications

## Overview
Receive automatic email alerts when important events occur in your account.

## Setting Up Notifications

1. Go to **Settings** → **Notifications**
2. Toggle the events you want to be notified about
3. Verify your email address
4. Click **Save Preferences**

## Available Notification Types

- **Security Alerts**: Login attempts, password changes
- **System Updates**: Maintenance windows, feature releases
- **Account Activity**: Billing changes, user additions

## Troubleshooting

**Problem**: Not receiving notifications  
**Solution**: Check spam folder, verify email address

## Related
- [Email Configuration](./email-config.md)
- [Security Settings](./security.md)

product-documentation