https://bugzilla.wikimedia.org/show_bug.cgi?id=29265
--- Comment #5 from Reedy <[email protected]> 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 [email protected] https://lists.wikimedia.org/mailman/listinfo/wikibugs-l
