- add better docs on the object mapping function