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

Thanks Cesar Canassa for the suggestion and Aymeric Augustin for review.
Backport of 566fca14b3 from master
This commit is contained in:
Adam Johnson 2019-09-25 10:28:08 +01:00
parent fcaaff9862
commit f4b7acedbf
1 changed files with 6 additions and 0 deletions

View File

@ -206,6 +206,12 @@ Defining and sending signals
Your applications can take advantage of the signal infrastructure and provide Your applications can take advantage of the signal infrastructure and provide
its own signals. 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 Defining signals
---------------- ----------------