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

Job	Run time
Close if invalid repo-sync PR author	0s
	0s

Provide feedback