> For the complete documentation index, see [llms.txt](https://marblejs.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://marblejs.gitbook.io/docs/other/migration-guides.md).

# Migration guides

It is hard to build a framework or big library that preserves the backward compatibility in every aspect from the very first iterations. We are still learning from release to release and want to deliver the best developer experience as possible without breaking changes, but as you know, it is not so simple. Sometimes you just find a better way of approaching the problem. Your point of view/perspective shifts as you mature as a developer — striving for perfection.

{% content-ref url="/pages/-MlUJoEV3I6OUio75Yy8" %}
[Migration from version 3.x](/docs/other/migration-guides/version-3.md)
{% endcontent-ref %}

{% content-ref url="/pages/-M-RdyMDrSCSoT\_Y4v8f" %}
[Migration from version 2.x](/docs/other/migration-guides/version-2.md)
{% endcontent-ref %}

{% content-ref url="/pages/-LXydGnyzBdwrEXMzDzm" %}
[Migration from version 1.x](/docs/other/migration-guides/version-1.md)
{% endcontent-ref %}