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? 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.
Thanks
Before someone come with something like: if documentation is wrong, fix it
I don't know what the correct way is, because I am following the documentation which is wrong, so until someone who knows how to do this right fix it, I won't know that either.
On Thu, Oct 30, 2014 at 10:11 AM, Petr Bena benapetr@gmail.com 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? 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.
Thanks
More ranting:
proper deprecated-message should look like this:
"foo is deprecated. Please use bar instead (see http://awesomedocs.net/how-to-use-bar.htm)"
It would be cool if mw devs who keep deprecating things would consider this.
Thanks
On Thu, Oct 30, 2014 at 10:12 AM, Petr Bena benapetr@gmail.com wrote:
Before someone come with something like: if documentation is wrong, fix it
I don't know what the correct way is, because I am following the documentation which is wrong, so until someone who knows how to do this right fix it, I won't know that either.
On Thu, Oct 30, 2014 at 10:11 AM, Petr Bena benapetr@gmail.com 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? 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.
Thanks
Why not use the always up-to-date API documentation returned by api.php itself? Rollback should be this doc-page: http://www.mediawiki.org/w/api.php?action=help&modules=rollback
Maybe you can help us fixing the API documentation, so, if you know, how to do a rollback, you can fix the doc on mw.org (don't forget to update the MW version the doc page refers to).
Freundliche Grüße / Kind regards, Florian Schmidt
-----Original-Nachricht----- Betreff: [Wikitech-l] rvtoken deprecated Datum: Thu, 30 Oct 2014 10:13:11 +0100 Von: Petr Bena benapetr@gmail.com An: Wikimedia developers wikitech-l@lists.wikimedia.org
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? 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.
Thanks
_______________________________________________ Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l
Hi,
I said that I don't know how to do this correctly, so I can't fix the documentation. So no, I will not fix it, because I can't.
Regarding your suggestion, it might be a good idea, but apparently even the "always up-to-date" API documentation returned by api.php is outdated and its example queries produces warning about deprecated values. Just have a look at http://www.mediawiki.org/w/api.php?action=help&modules=query%2Btokens which suggest http://www.mediawiki.org/w/api.php?action=query&meta=tokens which starts with a warning.
On Thu, Oct 30, 2014 at 11:13 AM, florian.schmidt.welzow@t-online.de florian.schmidt.welzow@t-online.de wrote:
Why not use the always up-to-date API documentation returned by api.php itself? Rollback should be this doc-page: http://www.mediawiki.org/w/api.php?action=help&modules=rollback
Maybe you can help us fixing the API documentation, so, if you know, how to do a rollback, you can fix the doc on mw.org (don't forget to update the MW version the doc page refers to).
Freundliche Grüße / Kind regards, Florian Schmidt
-----Original-Nachricht----- Betreff: [Wikitech-l] rvtoken deprecated Datum: Thu, 30 Oct 2014 10:13:11 +0100 Von: Petr Bena benapetr@gmail.com An: Wikimedia developers wikitech-l@lists.wikimedia.org
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? 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.
Thanks
Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l
Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l
Btw, I don't know if it's a bug or not, but http://www.mediawiki.org/w/api.php?action=query&meta=tokens&rawconti... returns no tokens even when I am logged in. According to always-up-to-date api.php I don't need to provide any more parameters for this to work. Is that a bug?
On Thu, Oct 30, 2014 at 11:26 AM, Petr Bena benapetr@gmail.com wrote:
Hi,
I said that I don't know how to do this correctly, so I can't fix the documentation. So no, I will not fix it, because I can't.
Regarding your suggestion, it might be a good idea, but apparently even the "always up-to-date" API documentation returned by api.php is outdated and its example queries produces warning about deprecated values. Just have a look at http://www.mediawiki.org/w/api.php?action=help&modules=query%2Btokens which suggest http://www.mediawiki.org/w/api.php?action=query&meta=tokens which starts with a warning.
On Thu, Oct 30, 2014 at 11:13 AM, florian.schmidt.welzow@t-online.de florian.schmidt.welzow@t-online.de wrote:
Why not use the always up-to-date API documentation returned by api.php itself? Rollback should be this doc-page: http://www.mediawiki.org/w/api.php?action=help&modules=rollback
Maybe you can help us fixing the API documentation, so, if you know, how to do a rollback, you can fix the doc on mw.org (don't forget to update the MW version the doc page refers to).
Freundliche Grüße / Kind regards, Florian Schmidt
-----Original-Nachricht----- Betreff: [Wikitech-l] rvtoken deprecated Datum: Thu, 30 Oct 2014 10:13:11 +0100 Von: Petr Bena benapetr@gmail.com An: Wikimedia developers wikitech-l@lists.wikimedia.org
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? 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.
Thanks
Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l
Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l
On 30 October 2014 21:42, Petr Bena benapetr@gmail.com wrote:
Btw, I don't know if it's a bug or not, but http://www.mediawiki.org/w/api.php?action=query&meta=tokens&rawconti... returns no tokens even when I am logged in. According to always-up-to-date api.php I don't need to provide any more parameters for this to work. Is that a bug?
The tokens show up fine for me. I assume you're logged in over HTTPS, in which case, they should show up if you also use HTTPS for the API: https://www.mediawiki.org/w/api.php?action=query&meta=tokens&rawcont...
Cheers, grunny
Indeed, that was it, thanks
On Thu, Oct 30, 2014 at 1:40 PM, Grunny mwgrunny@gmail.com wrote:
On 30 October 2014 21:42, Petr Bena benapetr@gmail.com wrote:
Btw, I don't know if it's a bug or not, but http://www.mediawiki.org/w/api.php?action=query&meta=tokens&rawconti... returns no tokens even when I am logged in. According to always-up-to-date api.php I don't need to provide any more parameters for this to work. Is that a bug?
The tokens show up fine for me. I assume you're logged in over HTTPS, in which case, they should show up if you also use HTTPS for the API: https://www.mediawiki.org/w/api.php?action=query&meta=tokens&rawcont...
Cheers, grunny
Wikitech-l mailing list Wikitech-l@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikitech-l
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...
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
wikitech-l@lists.wikimedia.org