revamped some docs and added some samples