add a bunch of examples to the documentation (didn't really test them, so hopefully they are correct)