update docs. update map handling