[rr-]

Docstring.params returned attributes along with params. A class docstring with both Args: and Attributes: gave one list, and users had to check kind to tell them apart. Linters such as pydoclint compare documented params against a signature and have to filter attributes out first.

docstring = parse("S.\n\nArgs:\n    x: X.\n\nAttributes:\n    y: Y.", "google")

# before
[p.arg_name for p in docstring.params]  # ['x', 'y']

# after
[p.arg_name for p in docstring.params]  # ['x']
[a.arg_name for a in docstring.attrs]   # ['y']

This is a breaking change for code that read attributes through params. Attributes are still DocstringParam objects with kind=Kind.ATTRIBUTE, so docstring.meta is unchanged. Only the params property filters differently. Attribute docstrings that parse_from_object reads from source show up in attrs too.

Compose works as before, because it writes items by kind. combine_docstrings matches the decorated function's signature against params only. Before, an attribute named like a param could be picked up as that param, or replace the param's description.

Parity against main: 0 of 29,074 docstrings differ (case, stdlib and generated), because parse output itself doesn't change. Bench on 3.8: 0.97–1.01x of main.