How to migrate from autodoc to autodoc2

[Josverl]

The name sort of implies that this is possible,
and I have found that it works much simpler for generating bulk documentation.
I am very please to find that it works well with python stub files, which saves me a lot of work.

But it is unclear to me how I can refer to individual classes / functions to allow me to mix handwitten docs with generated docs.

so for instance how to implement something similar to .. autoclass:: or .. autofunction::

.. currentmodule:: esp32

:mod:`esp32` --- functionality specific to the ESP32
====================================================

.. automodule:: esp32
    :no-members:
    :platform: esp32



Functions
---------

.. autofunction:: wake_on_touch

.. autofunction:: wake_on_ulp

[Josverl]

never mind, I've found autoapi to provide support for this.