I am going to document the changes in the relevant ticket: https://bugs.launchpad.net/oq-engine/+bug/1248237; in the upgrade script I will add a comment with a link to the ticket