Transform validators documentation needs an update.

[JonathanGzzBen]

In #687 I asked for help because I did not understand what the base function of validators should return, or how to mutate an option's value.