formatting improvements to upgrade guides