adding some examples, and improving docs (#67)