lots of transform doc improvements