start adding documentation on updating mapping

[trinity-1686a]

Description

add documentation on the known limitations when updating a doc mapping

@rdettai i know you were surprised by a few things, please step in if you think I missed anything important @fmassot you might have opinions on things to add too.

this is based on the expect stat of updates once all currently existing PR on the subject are merged