docs: enhance upgrade guide with alert formatting and decision matrix#42381

luizcireno-crypto wants to merge 2 commits intogithub:maingithub/docs:mainfrom

luizcireno-crypto:upgrade-guide-improvementsluizcireno-crypto/docs:upgrade-guide-improvementsCopy head branch name to clipboard