docstrings should be updated when the name of the parameter is changed

[kretes]

After doing a rename refactoring - the name of this parameter in the docstrings should change as well, currently it stays intact, and one need to change it manually

[gschwaer]

If someone was searching for this like I did: There is an alternative: darglint (see here). :rocket:

It will parse docstrings and complain if the parameters or type hints don't match.

If you want to combine that with flake8 in vscode, mind the comment here.