OceanParcels
Update tutorials to use and explain v4-API
In preparation for the Parcels anniversary event on 1 October 2025, it's good to update the tutorials to
- show the new v4 API
- explain to users what the key changes are between v3 and v4
2. explain to users what the key changes are between v3 and v4
Many packages publish a migration guide document when doing a major release. I think that this would also be beneficial for us to do. What are your thoughts on this?
- Have a migration guide and inline migration tips in the documentation
- Have a migration guide and have the documentation just focussed on v4
- Have no migration guide, and just inline migration tips in the documentation
I'd vote for a bit of a mixture between the first and the second. So have a migration guide, have the documentation just focussed on v4 and have (temporary) info boxes in the documentation that highlight and provide background on the changes with respect to v3 (but not really full migration tips)
To treat the migration guide as the 'source of truth' (and minimise duplication), we could do something along the lines of
```{tip}
The behaviour of ... has changed between v3 and v4 of Parcels. <more info if needed>
Make sure to check out [this section]() of our migration guide to see full info on how to
migrate to the new syntax.
```