diff --git a/docs/src/release_notes/v0.29.md b/docs/src/release_notes/v0.29.md
index 843e2d6dcf..ef4805c9a3 100644
--- a/docs/src/release_notes/v0.29.md
+++ b/docs/src/release_notes/v0.29.md
@@ -41,9 +41,9 @@ $carapace-spec.Spec(example.yaml)
 # invokes `carapace-spec _carapace macro "Spec(example.yaml)" ""`
 ```
 
-> This will change again in the future to support custom macros.
+> This behaviour will change slightly in the future to support custom macros.
 
-With the `--in-place` flag of `sed` this can be updated directly.
+With the `--in-place` flag of `sed` the specs can be updated directly.
 ```sh
 sed 's/$_/$carapace./g' ~/.config/carapace/specs/*.yaml
 ```