Jump to content

Requests for comment/Ditch crappy API formats

From mediawiki.org
Request for comment (RFC)
Ditch crappy API formats

noframe

Component General
Creation date
Author(s) MaxSem
Document status implemented
Approved -- Tim Starling (talk) 22:58, 12 November 2014 (UTC)[reply]
See Phabricator.

The initial goal of this RFC was the deprecation of several silly API output formats. However, this was generally achieved as part of the larger Requests for comment/API roadmap RFC, so I would like to concentrate on a clearer timeline for their complete removal.

Current state

[edit]

Here's the breakdown of API formats requested by users from Wikimedia sites during June 19, 2014:

375079448	json
34750831	xml
13068687	php
243625	xmlfm
71337	txt
62549	jsonfm
41158	text/x-wiki
34458	dbg
24460	yaml
7532	txtfm
34	yamlfm
31	dbgfm
28	none
25	rawfm
23	dump
22	phpfm
22	wddxfm
22	dumpfm
18	wddx
4	html
4	jsonf
3	jsonp
3	j
2	atom
2	raw
2	text
2	csv
2	PHP%20print_r()
1	wdxfm
1	default
1	pjson
1	xhtml
1	XML
1	plain
1	htmlfm
1	yamfm
1	xml%27
1	xm%20l
1	js
1	jsonaction%3Dquery
1	json%0D%0A
1	xml%27,%200,%20true
1	xml%27,0,true
1	jaon
1	xmuslfm

Proposal

[edit]

Set a clear date when a format should die. Contact major users of a format in advance to ensure they move off it, e.g. [1].

Proposed timeline:

  • 6 months for WDDX and dump.
  • 12 months for YAML, dbg and txt.