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.
Merge remote-tracking branch 'refs/remotes/ivan/feature/5506_use-pyside-slot-decorator' into develop