better documentation of IDMapper internals