An undocumented breaking change in data.json

Question

between the versions 1.1.0 and 2.0.0, data.json introduced a breaking change: The JSONWriter#-write signature changed from [object out] to [object out options]
On this commit:
https://github.com/clojure/data.json/commit/8f070ba94dc7c469f303259ce5f5bfa0b53d50bd
In release notes Release 2.0.0 on 2021-Mar-19 , there is no mention to JSONWriter or -write protocol changes.

I know it's a very old problem, but I think this documentation could be present.

Answer 1

I've updated the changelog to note this.

JSONWriter is not something users usually extend themselves, although it is available for that level of customization when necessary. However, we did know this had the potential to break some users and updated the version from 1.x to 2.x due to that.