Sweet! Here is first round of feedback:
- Parameter history is missing information about parameter that was deprecated in 1.26
- Embed the automated documentation and not link to it
- Let the first sample code be about how to get 2 random pages and the second one be about getting random set of pages including information such as titles, content, images, etc. Found this interesting link on Stackoverflow here: https://stackoverflow.com/questions/33614492/wikipedia-api-get-random-pages which talks about this use case and for which the final query would look like this: https://en.wikipedia.org/w/api.php?format=json&action=query&generator=random&grnnamespace=0&prop=revisions%7Cimages&rvprop=content&grnlimit=10.
- You could actually get rid of the additional notes section completely, as some of the information in there is in the automated docs and with the query above we will explain well how this module can be used as a generator..
May be you could make changes to the pull request accordingly and then I will take a look at it?