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.

Perhaps it's just my brain and way of processing, but I think it can be improved.

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 explanation of the general working of the  URL parameter.