@@ -1,9 +1,64 @@
11For the latest version of this document, please see [https://github.com/bos/aeson/blob/master/changelog.md](https://github.com/bos/aeson/blob/master/changelog.md).
22
3−### upcoming
3+### 1.4.7.0
4+
5+Long overdue release (once again), so there's quite a bit of stuff
6+included even though it's a "minor" release. Big thanks to all the
7+contributors, the project would not exist without you!
8+
9+Special thanks to Oleg Grenrus and Xia Li-Yao for reviewing tons
10+of stuff.
11+
12+New stuff:
13+
14+* Add `rejectUnknownFields` to Options which rejects unknown fields on
15+ deserialization. Useful to find errors during development, but
16+ enabling this should be considered a breaking change as previously
17+ accepted inputs may now be rejected. Thanks to rmanne.
18+
19+```
20+instance FromJSON Foo where
21+ parseJSON = gParseJSON defaultOptions { rejectUnknownFields = True }
22+```
423
524* `FromJSON` instance of `Ratio a` now parses numbers in addtion to
6− standard `{numerator=..., denumerator=...}` encoding.
25+ standard `{numerator=..., denumerator=...}` encoding. Thanks to
26+ Aleksey Khudyakov.
27+
28+* Add more information to parse errors, including a sample of the
29+ surrounding text. Hopefully this will lead to less "Failed to read:
30+ satisfy" confusion! Thanks to Sasha Bogicevic. We expect some
31+ downstream test suites to break because of this, apologies in
32+ advance. Hopefully you will like the improvement anyway :-)
33+
34+* Add `parseFail` to `Data.Aeson.Types`. `parseFail = fail` but
35+ doesn't require users to know about `MonadFail`. Thanks to Colin
36+ Woodbury.
37+
38+* Make Template Haskell type family detection smarter when deriving
39+ `ToJSON1` instances, thanks to Ryan Scott.
40+
41+* Optimize string parsing for the common case of strings without
42+ escapes, thanks to Yuras.
43+
44+
45+Misc:
46+
47+* Clean up compiler warnings and switch from base-compat to
48+ base-compat-batteries. Thanks to Colin Woodbury & Oleg Grenrus.
49+
50+* Clarification & fixes to documentation regarding treatment of Maybe fields, thanks to Roman Cheplyaka.
51+
52+* Add documentation for internal development workflows. Thanks to Guru
53+ Devanla.
54+
55+* Drop support for GHC < 7.8. We've chosen to support older GHCs as
56+ long as it doesn't prevent us from adding new features, but now it
57+ does! Thanks to Oleg Grenrus for the patch.
58+
59+* Allow generic-deriving 1.13 in test suite.
60+
61+* Some DRY fixes thanks to Mark Fajkus.
762
863### 1.4.6.0
964