added notes regarding sample usage