Last updated: Apr 03 2018

Upgrading to Find 13

This section describes breaking changes and upgrading procedures for Episerver Find 13.

Refer to Breaking changes in Episerver Find 13 for a complete list of changes.

What is a breaking change?

A breaking change is a change that might cause other components to fail. When a breaking change is done to the signature of a method/class/interface, the old signature is often kept intact but set as obsolete and may cause a warning message in Visual Studio. As long as the Visual Studio project setting "Treat Warnings as Errors" is not enabled in Visual Studio, you can postpone fixing these warnings to a later time.

Classes that expose constructors that take dependencies are normally deleted without an obsolete warning in major releases, since the compiler gives enough information about what to change. Keeping them makes dependency injection complex since there are multiple constructors to choose from that, over time, might or might not overlap.

In each major version, old obsolete methods are removed permanently to make sure that the API is kept clean and usable over time. So, it is good practice to fix all warning messages before upgrading to a major version.

Comments