Upgrading from 0.18.1 to 0.25.1 breaks site

Some general tips:

  • Read the Release Notes for every release and pay particular attention to the Notes section. We usually call out breaking changes and deprecated features in the Notes section.

  • If you’re several versions behind, consider updating to the latest minor releases between 0.18 and 0.25. So, build with 0.19, then 0.20.7, and so on. We will sometimes log warnings for a couple minor releases on deprecated features before we remove those features (and the warnings). You may find clues along the way that will help you upgrade your site.