[3.0.x] Documented admonition on when to use custom signals

Thanks Cesar Canassa for the suggestion and Aymeric Augustin for review.
Backport of 566fca14b3e1406f918898de5bb2b2382a44edaf from master
This commit is contained in:
Adam Johnson 2019-09-25 10:28:08 +01:00
parent fcaaff9862
commit f4b7acedbf

View File

@ -206,6 +206,12 @@ Defining and sending signals
Your applications can take advantage of the signal infrastructure and provide
its own signals.
.. admonition:: When to use custom signals
Signals are implicit function calls which make debugging harder. If the
sender and receiver of your custom signal are both within your project,
you're better off using an explicit function call.
Defining signals
----------------