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 <[email protected]> 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&rvtoken=rollback&titles=Main%20Page&format=xml >> >> 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/000067.html > > _______________________________________________ > Wikitech-l mailing list > [email protected] > https://lists.wikimedia.org/mailman/listinfo/wikitech-l _______________________________________________ Wikitech-l mailing list [email protected] https://lists.wikimedia.org/mailman/listinfo/wikitech-l
