Docs: Function decorator order should be specified

[malikoth]

I just spent some time trying to figure out why my @params function decorator didn't seem to be doing anything. My conclusion was that I put @params between the function signature, and the @get('some_endpoint') decorator. The @get has to be closest to the signature, and other decorators must be placed above that.

Wrong:

    @get('some_endpoint')
    @params({'key': 'value'})
    def some_func(self):
        """Call some endpoint"""

Right:

    @params({'key': 'value'})
    @get('some_endpoint')
    def some_func(self):
        """Call some endpoint"""

I think this should be called out in the documentation somewhere.