ignore local_mapping and add docs