pylint-errors

W9017 (differing-param-doc)

:x: Problematic code:

def foo(x, y):
    """A dummy string.

    :param int x: x value.
    :param int z: z value.
    :returns: a result.
    :rtype: int
    """

    return x + y

:heavy_check_mark: Correct code:

def foo(x, y):
    """A dummy string.

    :param int x: x value.
    :param int y: y value.
    :returns: a result.
    :rtype: int
    """

    return x + y

Rationale:

Please check parameter names in declarations.