Which docstring formatting standard am I supposed to be using? I noticed that some existing docstrings place an @ in front of parameter names in-line with otherwise unformatted descriptions, but that doesn't correspond to any of these:

Epytext syntax:

@type num_dogs: int
@param num_dogs: the number of dogs

Sphinx syntax:

:param param1: The first parameter, defaults to 1.
:type: int

Google syntax:

Args:
    param1 (int): The first parameter.

NumPy syntax:

Parameters
----------
param1 : int
    The first parameter.






Virus-free.www.avg.com