We need to document what is the process a developer should do when upgrading from one version to another.