small fixes and improvements
completing apidoc
correct sample