Improve Transforms documentation

[wujekbogdan]

Transforms are an awesome feature, but they aren't very straightforward to use. The API docs are very synthetic, as they are just auto-generated.

There are some real-life examples, but they are relatively basic compared to what Transforms can do.

Because of this, I find myself using unit tests as a form of documentation.

Is there any chance that the documentation will receive some love in the future?