add documentation for mapped