## Description - expand `upgrading.md` - alphabetize the changelog - update swagger with changes Closes: #XXX