More docs

I added a bunch of comments to help (new) users using the library more quickly. Please let me know if I got something wrong.