Minor cleanup to the mapping change docs

This tweaks some language, adds some lists, and fixes some incorrect
things.