Fix syntax error.
Add brief explanation of decorators

It turns out people reasonably new to Python were getting confused by the use of decorators.
Tweak SQL documentation a bit.