Improve docs for modifying metadata

[benjeffery]

From #3140

"Still, it'd be good to have not just "see here" but maybe a warning that in-place modification wont' work. (Also, those docs don't have the simplest use cases of "change an existing value in top-level metadata" or "change/add a value in each row".)"