fixing documentation and sample usage