issue #820: tried to improve upgrade notes