Docstring for Python method (NumPy-style, for Sphinx compatibility)

module-docstring.py

"""One line description of a module level function.

The longer, optionally multi-line description goes here. This may have multiple 
sentences and multiple lines.

Parameters
----------
param1 : int
    The first parameter.
param2 : Optional[str]
    The second parameter.
*args
    Variable length argument list.
**kwargs
    Arbitrary keyword arguments.


Returns
-------
return_var1 : bool
    True if successful, False otherwise.
return_var2 : float
    The area of a square.


Raises
------
AttributeError
    The ``Raises`` section is a list of all exceptions
    that are relevant to the interface.
ValueError
    If `param2` is equal to `param1`.

"""