@mstoelzle
Is there a more suitable way of documenting my class to obtain something readable?

@solangegbv I guess this part is not necessary, as at least the methods are documented separately below in the docstring of each method. I am using MKDocs. You could have a look at other examples of APIs that use MKDocs, for example, FastAPI.

Here, you can see the structure used to document the APIRouter class: https://github.com/fastapi/fastapi/blob/master/fastapi/routing.py#L596 with the resulting Doc. page: https://fastapi.tiangolo.com/reference/apirouter/