Skip to content

Commit

Permalink
[3.0.x] Documented admonition on when to use custom signals
Browse files Browse the repository at this point in the history
Thanks Cesar Canassa for the suggestion and Aymeric Augustin for review.
Backport of 566fca1 from master
  • Loading branch information
adamchainz committed Sep 25, 2019
1 parent fcaaff9 commit f4b7ace
Showing 1 changed file with 6 additions and 0 deletions.
6 changes: 6 additions & 0 deletions docs/topics/signals.txt
Original file line number Diff line number Diff line change
Expand Up @@ -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
----------------

Expand Down

0 comments on commit f4b7ace

Please sign in to comment.