AFAIU, this section should be moved into the UPGRADE-3.0.md file as this is when users need to make those changes at the latest. There is no need to make those changes for 2.5.