another bunch of docs fixes
lots of transform doc improvements
Merge pull request #349 from jabooth/moredocs

Transform documentation