more docu updates