Alternative for pydoctor to produce the python API documentation

[brockho]

Our documentation of the python modules (such as https://numbbo.github.io/coco-doc/apidocs/cocoex/) are done with the pydoctor tool that is outdated for some years now and very difficult to use (I think, only @nikohansen knows how to use it). What would be the best way to produce the documentation, if possible, in an automated way?

[tristanlatr]

Pydoctor is maintained upstream, it’s just that you guys use a very old version…

https://github.com/twisted/pydoctor

[olafmersmann]

We should add a task to build the API documentation in CI.