Hi,
You are right I am not subscribed to that list, however that doesn't change my opinion that documentation should be correct, otherwise you can't expect other devs to write their code properly, if you don't give them proper information how they should write it.
This should be responsibility of dev who submit a patch, to update the documentation as well. There is so many things being pedantically requested right now, such as having exact format of sentences in commit messages and such mostly useless stuff that isn't really good almost for anyone, but really important things from mediawiki user point of view are ignored. That seems quite weird to me.
On Thu, Oct 30, 2014 at 6:55 PM, Legoktm legoktm.wikipedia@gmail.com wrote:
On 10/30/14 2:11 AM, Petr Bena wrote:
Hello,
I am receiving lot of these warnings:
WARNING: API query (revisions): The rvtoken parameter has been deprecated.
According to current documentation for mediawiki at https://www.mediawiki.org/wiki/API:Rollback which I follow, in order to get a rvtoken I should use this query:
https://en.wikipedia.org/w/api.php?action=query&prop=revisions&rvtok...
however that very query returns this warning. Is this a bug in documentation?
Yes, the documentation is out of date. See bug 1.
Why do you first deprecate things and then, ages later, update the docs? Shouldn't it be the other way? Mediawiki has worst backward compatibility support I have ever seen and this is one of the reasons for it.
The docs on mediawiki.org are manually maintained. We're currently working towards automated docs that will stay up to date with the code, [1] says exactly which token type you need and from where.
AFAIS, the deprecated method still works fine. How is backwards-compatability support not here?
Also, are you subscribed to the mediawiki-api-announce mailing list[2]? It's useful if you want to be aware of what changes are planned/happening for the API. For example, the tokens change was announced[3] back in August.
-- Legoktm
[1] https://www.mediawiki.org/w/api.php?modules=rollback [2] https://lists.wikimedia.org/mailman/listinfo/mediawiki-api-announce [3] https://lists.wikimedia.org/pipermail/mediawiki-api-announce/2014-August/000...
Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l