# Guide Template (Diátaxis: How-To)

**Note:** This template is an alias for the How-To template. Use `how-to.md` for new guides.

Guides are task-oriented documentation that help users accomplish specific goals.

## When to Use

- User needs to solve a specific problem
- Task-focused documentation  
- Practical, goal-oriented scenarios

## See Also

For the full template, refer to: `how-to.md`

## Quick Reference

```mdx
---
title: How to [Achieve Specific Goal]
description: Learn how to [specific outcome]
contentType: how-to
---

## Overview

[2-3 sentences: What, Who, Why]

## Prerequisites (if applicable)

## Steps

<Steps>
  <Step title="[Action verb] [object]">Content</Step>
</Steps>

## Example

## Next Steps
```

## Content Type Classification

When creating documentation, classify each page using the Diátaxis framework:

| Type | Template | Purpose |
|------|----------|---------|
| Tutorial | `tutorial.md` | Learning-oriented, build understanding |
| How-To Guide | `how-to.md` | Task-oriented, accomplish goals |
| Reference | `reference.md` | Information-oriented, look up facts |
| Explanation | `explanation.md` | Understanding-oriented, comprehension |

## Writing Guidelines

1. **Second Person** - "You can configure..." not "Users can configure..."
2. **Active Voice** - "Run the command" not "The command should be run"
3. **Task-Oriented Headings** - "How to add a custom domain" not "Custom domains"
4. **Include Examples** - Every concept needs a code example
5. **Progressive Disclosure** - Basic → Advanced ordering
