[Bug 29265] Mediawiki API documentation incomplete
https://bugzilla.wikimedia.org/show_bug.cgi?id=29265 Mark A. Hershberger changed: What|Removed |Added Priority|Normal |Lowest Status|NEW |RESOLVED Resolution||FIXED --- Comment #9 from Mark A. Hershberger 2011-06-10 20:49:10 UTC --- closing. Please refrain from reopening unless you have some specific thing that you think needs to be documented better and that isn't addressed by the above comments. -- Configure bugmail: https://bugzilla.wikimedia.org/userprefs.cgi?tab=email --- You are receiving this mail because: --- You are on the CC list for the bug. ___ Wikibugs-l mailing list Wikibugs-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikibugs-l
[Bug 29265] Mediawiki API documentation incomplete
https://bugzilla.wikimedia.org/show_bug.cgi?id=29265 --- Comment #8 from Reedy 2011-06-05 15:10:36 UTC --- r89505 adds the information about erroneous requests to the API help output -- Configure bugmail: https://bugzilla.wikimedia.org/userprefs.cgi?tab=email --- You are receiving this mail because: --- You are on the CC list for the bug. ___ Wikibugs-l mailing list Wikibugs-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikibugs-l
[Bug 29265] Mediawiki API documentation incomplete
https://bugzilla.wikimedia.org/show_bug.cgi?id=29265 --- Comment #7 from Reedy 2011-06-05 14:53:57 UTC --- MW.org http://www.mediawiki.org/w/index.php?title=API%3AMain_page&action=historysubmit&diff=407748&oldid=401839 -- Configure bugmail: https://bugzilla.wikimedia.org/userprefs.cgi?tab=email --- You are receiving this mail because: --- You are on the CC list for the bug. ___ Wikibugs-l mailing list Wikibugs-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikibugs-l
[Bug 29265] Mediawiki API documentation incomplete
https://bugzilla.wikimedia.org/show_bug.cgi?id=29265 --- Comment #6 from Reedy 2011-06-04 11:31:35 UTC --- Maxlag documentation fleshed out on API inbuilt help in r89461 -- Configure bugmail: https://bugzilla.wikimedia.org/userprefs.cgi?tab=email --- You are receiving this mail because: --- You are on the CC list for the bug. ___ Wikibugs-l mailing list Wikibugs-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikibugs-l
[Bug 29265] Mediawiki API documentation incomplete
https://bugzilla.wikimedia.org/show_bug.cgi?id=29265 --- Comment #5 from Reedy 2011-06-04 10:05:06 UTC --- (In reply to comment #4) > @Reedy > > The lack of documentation is abhorrent. This isn't a half-baked alpha API, and > neither is this a proprietary API...this is supposed to be FOSS. > > A public API isn't meant to be an exercise in reverse engineering... That at best, is slightly an overstatement. The API pro-rata to most of the project is well documented, both with the internal and the more external facing documented. Granted, it's not perfect, but what FOSS project is. When you don't pay people to write documentation, chances are, they won't. This seems very reverse to what most people have said, with it often being reasonably well congratulated of it being there. Even when I was using 3-4 years ago as just a consumer, I rarely had any difficulties, usually it was when using strange parameter combinations, but it was worked out. Similarly, if it is "so abhorrent", why don't we have more complaints of things being bad? Usually people have nitpicks over little bits and pieces, but it's never "OMG THE DOCUMENTATION IS SO BAD I CANT FUCKING USE THIS" Unfortunately we are both not mind readers, and also mixed ability end user consumers. We can't work out what you think is wrong, so unless people tell us, it's a wild stab in the dark. And on that the only issues you seem to bring up, is 1 poorly documented parameter, and the fallback "error" which brings you to the help page in a lot of cases. I've no idea how you get from 2 omissions/errors -- Configure bugmail: https://bugzilla.wikimedia.org/userprefs.cgi?tab=email --- You are receiving this mail because: --- You are on the CC list for the bug. ___ Wikibugs-l mailing list Wikibugs-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikibugs-l
[Bug 29265] Mediawiki API documentation incomplete
https://bugzilla.wikimedia.org/show_bug.cgi?id=29265 Mark A. Hershberger changed: What|Removed |Added Priority|Unprioritized |Normal CC||m...@everybody.org -- Configure bugmail: https://bugzilla.wikimedia.org/userprefs.cgi?tab=email --- You are receiving this mail because: --- You are on the CC list for the bug. ___ Wikibugs-l mailing list Wikibugs-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikibugs-l
[Bug 29265] Mediawiki API documentation incomplete
https://bugzilla.wikimedia.org/show_bug.cgi?id=29265 --- Comment #4 from Smallman 2011-06-04 00:59:10 UTC --- @Reedy The lack of documentation is abhorrent. This isn't a half-baked alpha API, and neither is this a proprietary API...this is supposed to be FOSS. A public API isn't meant to be an exercise in reverse engineering... -- Configure bugmail: https://bugzilla.wikimedia.org/userprefs.cgi?tab=email --- You are receiving this mail because: --- You are on the CC list for the bug. ___ Wikibugs-l mailing list Wikibugs-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikibugs-l
[Bug 29265] Mediawiki API documentation incomplete
https://bugzilla.wikimedia.org/show_bug.cgi?id=29265 --- Comment #3 from Reedy 2011-06-03 23:02:26 UTC --- (In reply to comment #2) > Maxlag appears to be documented only as "maxlag - Maximum lag" which I'm not > sure is very helpful. :) > > There is a prominent link to http://www.mediawiki.org/wiki/API ... but there's > no obvious link to maxlag info there either. > > If you search on mediawiki.org you can turn up this page: > > http://www.mediawiki.org/wiki/Manual:Maxlag_parameter > > Perhaps we can have the help link to some of these detail pages directly? People should think themselves lucky they get any documentation at ALL! =D -- Configure bugmail: https://bugzilla.wikimedia.org/userprefs.cgi?tab=email --- You are receiving this mail because: --- You are on the CC list for the bug. ___ Wikibugs-l mailing list Wikibugs-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikibugs-l
[Bug 29265] Mediawiki API documentation incomplete
https://bugzilla.wikimedia.org/show_bug.cgi?id=29265 Brion Vibber changed: What|Removed |Added Blocks||1 --- Comment #2 from Brion Vibber 2011-06-03 18:14:15 UTC --- Maxlag appears to be documented only as "maxlag - Maximum lag" which I'm not sure is very helpful. :) There is a prominent link to http://www.mediawiki.org/wiki/API ... but there's no obvious link to maxlag info there either. If you search on mediawiki.org you can turn up this page: http://www.mediawiki.org/wiki/Manual:Maxlag_parameter Perhaps we can have the help link to some of these detail pages directly? -- Configure bugmail: https://bugzilla.wikimedia.org/userprefs.cgi?tab=email --- You are receiving this mail because: --- You are on the CC list for the bug. ___ Wikibugs-l mailing list Wikibugs-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikibugs-l
[Bug 29265] Mediawiki API documentation incomplete
https://bugzilla.wikimedia.org/show_bug.cgi?id=29265 --- Comment #1 from Reedy 2011-06-03 17:41:31 UTC --- Maxlag is documented at the top of the page -- Configure bugmail: https://bugzilla.wikimedia.org/userprefs.cgi?tab=email --- You are receiving this mail because: --- You are on the CC list for the bug. ___ Wikibugs-l mailing list Wikibugs-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikibugs-l