Update decorator docs with better intro

Include note on globals.
Simplify python code.