Upgrade

Detailed guidance, architecture, best practices, implementation notes, references and diagrams placeholder.