More Map Change Related Documentaion

[adrienntindall]

Still trying to get back into the swing of things so keeping it small, will update till I get some feedback mostly on the new names

[lhearachel]

Just noting that this needs to be run through clang-format; it cannot be merged until that is done