Add code examples in docstrings

[eliascarv]

We need code examples in the transformations to have good documentation.

[juliohm]

This is already part of #43 right? Can we concentrate our docs discussion there?

[eliascarv]

OK