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)