# How-To Guides

**Practical guides for tackling common tasks & specific problems.**

These how-to guides are focused on **getting things done.** Each guide addresses a specific use case or problem you might encounter when working with Flycatcher.

## 📋 Available Guides

### Validation

- **[Custom Validators](custom-validators.md)** - Implement cross-field validation and business rules

## 🔜 Coming Soon

### Data Operations
- **Bulk Database Writes** - Efficiently insert/update large DataFrames
- **Schema Migrations** - Evolve your schemas over time
- **Handling Nested Data** - Work with complex data structures

### Integration
- **FastAPI Integration** - Use Flycatcher schemas in FastAPI applications
- **Data Pipeline Patterns** - Common ETL patterns with Flycatcher
- **Testing Schemas** - Best practices for testing your schemas

### Performance
- **Optimizing Validation** - Speed up validation for large datasets
- **Chunked Processing** - Handle DataFrames too large for memory

## 📚 Other Documentation

- **[Tutorials](../tutorials/index.md)** - Step-by-step learning paths for beginners
- **[Examples](../examples.md)** - Practical end-to-end examples of using Flycatche0
- **[API Reference](../api/index.md)** - Complete API documentation

<!-- - **[Explanations](../explanations/index.md)** - Deep dives into concepts and design decisions -->

## 💡 Can't Find What You Need?

If you have a specific use case that isn't covered:

<!-- 1. Check if it's explained in the [Explanations](../explanations/index.md) section -->
1. Search the [API Reference](../api/index.md) for relevant functions
2. Ask in [GitHub Discussions](https://github.com/mrmcmullan/flycatcher/discussions)
3. [Open an issue](https://github.com/mrmcmullan/flycatcher/issues) requesting a new guide
