Add code examples to documentation

[s-fleck]

For new users (like me) code examples can be very helpful in understanding a library. I added two somewhat specific examples for tasks that I needed for a project to the documentation. I pieced these together by sifting through the unit tests, so I am not sure if it is the best way to go about it.

If you are interested I could expand this pull request a bit by adding more examples and maybe some text.

[sampsyo]

This looks awesome!! Thanks for adding these. I'll merge these now because they're valuable by themselves, but please feel free to add even more examples if you do have them!