In your tutorial, you suggest using , optional after the parameter type to denote that a parameter is optional.
However, according to the following sources, this is not the official syntax for sphinx/reStructuredText docstrings:
Moreover, Sphinx procudes a warning when used in nit-picky mode:
WARNING: py:class reference target not found: optional
Thus, I suggest removing this syntax from the tutorial. I'm sorry if I missed any important resources.
In your tutorial, you suggest using
, optionalafter the parameter type to denote that a parameter is optional.However, according to the following sources, this is not the official syntax for sphinx/reStructuredText docstrings:
Moreover, Sphinx procudes a warning when used in nit-picky mode:
WARNING: py:class reference target not found: optionalThus, I suggest removing this syntax from the tutorial. I'm sorry if I missed any important resources.