api change, docs addition
added docs