Last modified: 2014-10-28 14:45:53 UTC
Go to https://en.wikipedia.org/w/api.php and search for "dir " (with the space). There will be 43 results. Of these, only a few (9 results) have an explanation of the meaning of "newer" and "older", like this: --------------------------------------------------------------- rvdir - In which direction to enumerate (enum) newer - List oldest first. Note: rvstart has to be before rvend. older - List newest first (default). Note: rvstart has to be later than rvend. One value: newer, older Default: older --------------------------------------------------------------- The others are documented like so: --------------------------------------------------------------- afldir - The direction in which to enumerate One value: newer, older Default: older --------------------------------------------------------------- This could be improved to match the first example above. It seems includes/api/ApiQueryBase.php has a function getDirectionDescription to help with this.
I would like to work on this bug. Please assign it to me.
Created attachment 16870 [details] The attached file improves documentation of API's "dir" parameter (which accept values older, newer) 'dir' parameter which accepts as values newer, oldest is now properly documented in several places on the attached XML file.
Thank you dkontotasiu. Just wondering, wouldn't it be better to submit a patch for review?
(In reply to Quim Gil from comment #3) > Just wondering, wouldn't it be better to submit a patch for review? Very much so. A hand-edited version of the auto-generated documentation (that was redone completely in Gerrit change #161093) isn't likely to get results.
