documentation-patterns

# Documentation Patterns Skill

Patterns for organizing and structuring documentation.

## Documentation Types

### Reference Documentation

Technical specifications and API details.

```markdown
## Function: createUser

Creates a new user in the system.

### Signature

\`\`\`typescript
function createUser(data: CreateUserData): Promise<User>
\`\`\`

### Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| data.email | string | Yes | User's email address |
| data.name | string | No | Display name |
| data.role | UserRole | No | Default: "user" |

### Returns

`Promise<User>` - The created user object

### Throws

- `ValidationError` - If email format is invalid
- `ConflictError` - If email already exists

### Example

\`\`\`typescript
const user = await createUser({
  email: 'john@example.com',
  name: 'John Doe'
})
\`\`\`
```

### Conceptual Documentation

Explains concepts and architecture.

```markdown
# Authentication Architecture

## Overview

The authentication system uses JWT tokens for stateless authentication.

## Components

### Token Service

Responsible for generating and validating tokens.

### Session Manager

Manages user sessions and refresh tokens.

## Flow

1. User submits credentials
2. Server validates credentials
3. Server generates JWT token
4. Client stores token
5. Client sends token with requests
6. Server validates token on each request

## Security Considerations

- Tokens expire after 1 hour
- Refresh tokens valid for 30 days
- Tokens are signed with RS256
```

### Procedural Documentation

Step-by-step instructions.

```markdown
# Setting Up Local Development

## Prerequisites

- Node.js 18+
- PostgreSQL 15
- Redis 7

## Steps

### 1. Clone the Repository

\`\`\`bash
git clone https://github.com/org/repo.git
cd repo
\`\`\`

### 2. Install Dependencies

\`\`\`bash
npm install
\`\`\`

### 3. Configure Environment

\`\`\`bash
cp .env.example .env
# Edit .env with your settings
\`\`\`

### 4. Start