Upgrade Guide

Detailed upgrade guide for upgrading between breaking versions

Intro

As this package adheres to Semantic Versioning this document thereby describes the necessary steps to upgrade between two major versions.