doc-en
doc-en copied to clipboard
Improve documentation on callables
This implements #4355 :
- added a note that warns about passing protected/private class/instance methods
- provide additional examples of manually invoking the callbacks
The goal is that, by providing examples of how callbacks may be manually used, the reader becomes convinced that passing protected/private methods as callables to the outside world is generally a bad idea.