[Documentation] Add information about optional args

[sylvlecl]

• Do you want to request a feature or report a bug?

Doc

• What is the current behavior?

Optional arguments and their default value are only visible in methods signatures.

It would be a little more helpful to add more information about them in the docstrings.