Decorator order bug

[AlejandroFernandezLuces]

Decorators @kwargs_passed_not_accepted and @deprecated_argument need to be called in a specific order. Let's try to fix this for the decorators to be able to be called with no issues in order, or just document that they need to be called one before the other.

[RobPasMue]

Thanks for handling #2337 @AlejandroFernandezLuces -- I'll look into this