[pylint] docstring default/optional updates

In docstrings we need to check that the signature and the docstring types are the same.

That means that if something is optional in the docstring, it should also be optional in the signature. If a parameter has a default value we need that value to be present in the docstring as well. this will improve our sphinx docs