documented ’simplified’ syntax
wording
styling
yanked the ’inline transforms’ antipattern
added context mgr usage
fixed arg descriptions
better flow in the intros