diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0c26b833e8..1582035b53 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -34,6 +34,10 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 * The `git.push-branch-prefix` config has been deprecated in favor of
   `git.push-bookmark-prefix`.
 
+* `conflict()` and `file()` revsets have been renamed to `conflicts()` and `files()`
+  respectively. The old names are still around and will be removed in a future
+  release.
+
 ### New features
 
 * The new config option `snapshot.auto-track` lets you automatically track only
@@ -94,10 +98,6 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
   commit to commit. It now either follows the flags `--edit|--no-edit` or it
   gets the mode from `ui.movement.edit`.
 
-* `conflict()` and `file()` revsets have been renamed to `conflicts()` and `files()`
-  respectively. With this, all revsets that could potentially return multiple
-  results are named in the plural.
-
 ### Deprecations
 
 * `jj untrack` has been renamed to `jj file untrack`.