Re: [Wikitech-l] Documentation for API query/revisions needs an update

2018-08-02 Thread Gergo Tisza
On Thu, Aug 2, 2018 at 11:22 PM Nicolas Vervelle 
wrote:

> This rvslots is not documented on API:Revisions and I don't find an email
> mentionning a compatibility problem on this subject.
>
> I tried the API Sandbox, but the documentation for rvslots is cryptic for
> me : " Which revision slots to return data for, when slot-related
> properties are included in rvprops. If omitted, data from the main slot
> will be returned in a backwards-compatible format."
>
> Any understandable explanation on this parameter and what value should I
> put, and what difference should I expect in the result ?
>

Oops, sorry. I will fix the docs and send an announcement tomorrow. This is
for new functionality that is being added to MediaWiki incrementally as
part of the Multi-Content Revisions project [1].

You can safely ignore the warning for now. You can specify rvslot=main,
which will give you the same data, but in a slightly different format (and
some deprecated options will trigger an error). At this point in time, no
other slots are supported. Wikimedia Commons will soon have another slot
available, for structured media information - see the Structured Data on
Commons project [2] for details.

[1]
https://www.mediawiki.org/wiki/Requests_for_comment/Multi-Content_Revisions
[2] https://commons.wikimedia.org/wiki/Commons:Structured_data
___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l

[Wikitech-l] Documentation for API query/revisions needs an update

2018-08-02 Thread Nicolas Vervelle
Hi,

today, I noticed that I was getting API warnings in WPCleaner for each call
to API query/revisions :
revisions - Because "rvslots" was not specified, a legacy format has been
used for the output. This format is deprecated, and in the future the new
format will always be used.

This rvslots is not documented on API:Revisions and I don't find an email
mentionning a compatibility problem on this subject.

I tried the API Sandbox, but the documentation for rvslots is cryptic for
me : " Which revision slots to return data for, when slot-related
properties are included in rvprops. If omitted, data from the main slot
will be returned in a backwards-compatible format."

Any understandable explanation on this parameter and what value should I
put, and what difference should I expect in the result ?

Thanks
Nico
___
Wikitech-l mailing list
Wikitech-l@lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/wikitech-l