# Migration Guides

Upgrade guides for major version changes in cov-loupe.

## Available Guides

- [Migrating to v5](MIGRATING_TO_V5.md) - Upgrade from v4.x to v5.x
- [Migrating to v4](MIGRATING_TO_V4.md) - Upgrade from v3.x to v4.x
- [Migrating to v3](MIGRATING_TO_V3.md) - Upgrade from v2.x to v3.x
- [Migrating to v2](MIGRATING_TO_V2.md) - Upgrade from v1.x to v2.x

## General Migration Tips

1. Always review the [Release Notes](../../release_notes.md) for your target version
2. Run your test suite after upgrading to catch any breaking changes
3. Check the [Troubleshooting Guide](../TROUBLESHOOTING.md) if you encounter issues

## Need Help?

If you encounter issues during migration, please:
- Check the relevant migration guide above for your version
- Review the [Troubleshooting Guide](../TROUBLESHOOTING.md)
- Search or open an issue on [GitHub](https://github.com/keithrbennett/cov-loupe/issues)
