Migration Guide
Sometimes, a new version of a package will introduce changes which could be breaking. We made it part of the development process to document these changes inside the MIGRATION.md
file of the app
package. This file will contain a list of changes and how to migrate from the old to the new version.
Since developers eventually must manually update their own codebase, we are particularly careful to document these changes and make it as easy as possible to migrate.
The MIGRATION.md
file follows this schema:
## x.y.z (DD.MM.YYYY)
### `path/to/file_1.extension`
- logic that needs to be changed is described here
```diff
- removed line
+ added line
```
Since the version and date under which the changes are made are not known at
the time of the PR, those need to be set when
release-please (opens in a new tab) creates the
release PR. That means editing the MIGRATION.md
file during the review of
the release PR. Instead of the version you can use x.y.z
and DD.MM.YYYY
as
a placeholder.
The migration file can be found here: MIGRATION.md (opens in a new tab)