added docs on conversion with mapping