Make documentation on transformations consistent with the code

There were some differences in conventions.