Eample Python docstring from Google's guidlines

python-example-docstring.md

def func(x, y, *args, **kwargs):
    """Summary
    
    Parameters:
      x (int) : first parameter
      y: second parameter
        with longer description
        
    Raises:
     Exception: if anything bad happens
    Returns:
      None: always   
    """
    pass

Other documentation formatting examples linked in this SO answer:

http://stackoverflow.com/a/34212785/1913888