python multiline docstring styles

1def some_function(argument1):
2    """Summary or Description of the Function
3
4    Parameters:
5    argument1 (int): Description of arg1
6
7    Returns:
8    int:Returning value
9
10   """
11
12    return argument1
13
14print(some_function.__doc__)
15

1class Vehicle(object):
2    '''
3    The Vehicle object contains lots of vehicles
4    :param arg: The arg is used for ...
5    :type arg: str
6    :param `*args`: The variable arguments are used for ...
7    :param `**kwargs`: The keyword arguments are used for ...
8    :ivar arg: This is where we store arg
9    :vartype arg: str
10    '''
11
12
13    def __init__(self, arg, *args, **kwargs):
14        self.arg = arg
15
16    def cars(self, distance, destination):
17        '''We can't travel a certain distance in vehicles without fuels, so here's the fuels
18
19        :param distance: The amount of distance traveled
20        :type amount: int
21        :param bool destinationReached: Should the fuels be refilled to cover required distance?
22        :raises: :class:`RuntimeError`: Out of fuel
23
24        :returns: A Car mileage
25        :rtype: Cars
26        '''  
27        pass
28

1def functionName():
2    """
3    This is a function docstring
4    """