User:Retro/API documentation

I find the Mediawiki Action API documentation pages unclear and poorly organized. To contrast, I have found Manual:Database layout to be quite clear for the most part.

This is apparently already tracked in T198916.

In that task, it's said they'll prioritize the "20 most viewed pages", but that discounts the possibility that there are missing pages that would be more useful to create than the existing pages.

Take for example the beginning of API:Query:

"The module allows you to get information about a wiki and the data stored in it, such as the wikitext of a particular page, the links and categories of a set of pages, or the token you need to."

This doesn't link to an explanation of the general working of the  URL parameter.

Also, I'm interested in seeing more about the return format.

List of API pages

 * Full list: This includes each language variant; ideally I could filter this down to only use the base variant.