[ci skip] Update on the changes from PR #3388

 - Fixed a broken link
 - Added missing notes about deprecations in the upgrade instructions
 - Improved consistency with other deprecation notices in the docs