| daniel created this task. daniel added a project: Wikidata. Herald added a subscriber: Aklapper. |
TASK DESCRIPTION
We should make clear to 3rd party users of our data and APIs what stability guarantees we give (and don't give).
The idea is to make explicit the implications of the robustness principle in the context of Wikibase.
In particular:
- JSON and XML may contain additional fields, attributes, or elements in any location.
- Entity types, data types, and value types may be added. Clients should handle unknown kinds of elements or values gracefully.
- The MediaWiki web API modules are considered a stable interface. This also applies to the serialization formats supported for output.
- "stable" currently does not mean "versioned". It currently only means that due notice will be given of breaking changes.
- Other stable interfaces are the output of Special:EntityData and the format used in JSON and RDF dumps.
- The contents of MediaWiki XML dumps is not a stable interface.
Some key parts of such a policy document are outlined in an email to wikitech-l from February 5 2016: On interface stability and forward compatibility.
The policy needs to be findable on mediawiki.org, and should be prominently linked from Wikibase/DataModel/JSON and similar pages.
TASK DETAIL
EMAIL PREFERENCES
To: daniel
Cc: Lydia_Pintscher, mkroetzsch, Aklapper, daniel, D3r1ck01, Izno, Wikidata-bugs, aude, Mbch331
Cc: Lydia_Pintscher, mkroetzsch, Aklapper, daniel, D3r1ck01, Izno, Wikidata-bugs, aude, Mbch331
_______________________________________________ Wikidata-bugs mailing list Wikidata-bugs@lists.wikimedia.org https://lists.wikimedia.org/mailman/listinfo/wikidata-bugs
