Added reason field information.
Merge pull request #1143 from cmfcmf/documentation

Added reason field information to UPGRADING docs