Is your feature request related to a problem? Please describe.
Currently theDeveloping autodoc extensions is using the legacy interface. It is not clear how one is supposed to do the same with the new interface. Afaict, this is not yet a solved problem right now.

While we are at it, it would be nice to actually clarify:

• What does extending autodoc do and what you can overwrite. The example seems to focus on adding to the contents, but what about other things that you would want to do like changing the signature?
• How does it play withautomodule orsphinx-apidoc?
• What are some usecases where you would want to do that? I can imagine it would be useful fordataclasses and equivalents likeattrs,pydantic, and those providing appropriate extensions to auto-document?
• Can an object be autodocumented twice (maybe withno-index), once asautoclass in thesphinx-apidoc and once as your custom method somewhere else in your document? Are there pitfalls to be aware of when doing so?

Additional context

• Split off fromRestore the legacy implementation of autodoc for compatibility #14091 (comment)