updated docs with mapping methods