add comments, update samples