rearrange documentation; deprecate transforming operations