minor simplification
update some docs