docs(upgrade-guide): fix typos + minor adjustment in new section