how-to-documentation

name	How-To Documentation
description	This skill should be used when creating documentation, writing instructions, capturing reusable procedures, or when the user asks to 'create a how-to' or 'document a procedure'. Provides guidance for creating effective how-to documentation.

Writing How-To Guides

When to Write a How-To

Create a how-to when you:

• Do something more than once
• Figure out a non-obvious procedure
• Want to standardize a workflow
• Document a fix that might recur

Structure of a Good How-To

1. Clear Title

Start with "How to..." and be specific:

• Good: "How to deploy to production"
• Bad: "Deployment"

2. Context

Brief explanation of when to use this guide:

Use this guide when you need to release a new version to production.
Prerequisites: All tests passing, version bumped.

3. Step-by-Step Instructions

Numbered steps, each doing one thing:

1. Ensure all tests pass: `just test`
2. Bump the version in Cargo.toml
3. Create a git tag: `git tag v1.2.3`
4. Push with tags: `git push --tags`
5. Wait for CI to publish

4. Troubleshooting (Optional)

Common problems and solutions:

## Troubleshooting

### CI fails on publish
- Check if version already exists on registry
- Verify credentials are not expired