# Migration guide for updating between openscenario-rs versions
This document contains:
- Step-by-step migration instructions for major version updates
- Breaking change explanations and workaround strategies
- Deprecated API usage patterns and modern alternatives
- Automated migration tools and scripts where applicable
- Version compatibility matrix and support lifecycle information
Contributes to project by:
- Enabling smooth upgrades between library versions
- Reducing migration friction and adoption barriers
- Providing clear communication about breaking changes
- Supporting long-term maintenance and API evolution
- Facilitating user retention through upgrade assistance