Improve upgrade guide documentation about the PUT->PATCH change

Further improvements to the upgrade guide re: #10747