Use Slot decorator instead of SLOT docstring.
Use consistent wording for triggers documentation.
Improve parameters docstrings.

Also rename a parameter named 'param' to a more meaningful 'idx'.
Add changes file for #5506.