Merge branch 'lukeshu/break'

1 files changed, 22 insertions, 0 deletions

diff --git a/ReleaseNotes.md b/ReleaseNotes.md
index e4327db..874aeec 100644
--- a/ReleaseNotes.md
+++ b/ReleaseNotes.md
@@ -1,3 +1,25 @@
+# v0.3.0 (TBD)
+
+  Theme: Breaking changes
+
+  This release makes a breaking change to the way *ReEncoder works.
+  This change both better fits what's convenient to use, and enables
+  making future performance improvements.
+
+  Breaking changes:
+
+   - ReEncoder: Instead of instantiating a `*ReEncoder` with
+
+       ```go
+       reenc := &lowmemjson.ReEncoder{Out: w, settings}
+       ```
+
+     it is now instantiated with
+
+       ```go
+       reenc := lowmemjson.NewReEncoder(w, lowmemjson.ReEncoderConfig{settings})
+       ```
+
 # v0.2.1 (2023-01-30)
 
   Theme: Code quality