See also "SOA proliferation through specification" in https://phabricator.wikimedia.org/T86028. James is planning to talk about our use of Swagger API specs for configuration, documentation, sandboxing & testing in restbase.

At first I thought this is about user documentation, but it seems it is about developer documentation. Is that correct? They are quite different things.

For developer documentation, I would like to have a way for extensions to have same kind of documentation as core generated automatically and found in same places.

In T86050#975769, @Nikerabbit wrote:

At first I thought this is about user documentation, but it seems it is about developer documentation. Is that correct?

Yes, thanks Quim and MZ for renaming. Developer documentation at developer summit.

For developer documentation, I would like to have a way for extensions to have same kind of documentation as core generated automatically and found in same places.

A few extensions are doing this, e.g. MultiMediaViewer. I only see extensions doing it for their JS with JSDuck (see config), but CSS doc with KSS and PHP doc with doxygen are probably doable as well. Meanwhile mediawiki-mirror on tool labsseems to generate PHP doc for all extensions.

It's a good topic for the session, I hope you can come.

Please update the description with the achievements of this session. Thank you in advance.