JSON formatversion

[hartman]

Another thing you might want to consider adding to your default options is formatversion=2.

https://www.mediawiki.org/wiki/API:JSON_version_2

[Fannon]

That's an interesting idea (I don't like the default JSON output, either), but I'm not quite sure that it's worth the consequences: It would make mwbot by default not compatible with MW < 1.25. Having compatibility with older wikis is something I need for my own use cases.

but do note that the output formatting isn't entirely stable yet and might change in MediaWiki 1.26.

This is also making me a bit unsure, because it indicates that at best the documentation is not up to date, at worst that the new API is not reliable, yet.

One compromise I could think of is having a configuration to optionally activate json v2 output. I'd have to make sure that convenience functions like .batch() will detect whether the outut is v1 and v2 and support both.

What are your expeniences with the version 2 JSON format? Thanks for your input!