I'm trying to understand the "solution ecosystem" with respect to creating docstrings, and then generating some nice reference documentation with PyCharm/IntelliJ.
I'm used to the Google style docstrings, and am confused by PyCharm's default docstring skeleton format/style however:
"""
:param <paramname>: blah blah
:return None
"""
What style is this and what reference doc generators does it work with? Is there a style guide somewhere?
Those are the Sphinx style doc strings.
Python has some strong opinions about doc strings, see PEP257.
Here is a full description of all of the doc string types in Python: What is the standard Python docstring format?