document all the changes around callbacks in mappings