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(a)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&rvto…
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/00…
_______________________________________________
Wikitech-l mailing list
Wikitech-l(a)lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l