Adding more to decorator docs

[jocho-here]

I wasn't able to find a way to properly use the transaction decorator when using with other decorators in the docs. I thought it would be helpful to add this portion so others can also be aware they need to put the decorator right above the function signature without going into the code and finding out about it themselves.