diff --git a/docs/src/release_notes/v0.25.md b/docs/src/release_notes/v0.25.md
index 4aa0e54ead..b4c296faf9 100644
--- a/docs/src/release_notes/v0.25.md
+++ b/docs/src/release_notes/v0.25.md
@@ -1,7 +1,7 @@
-# v0.25 Window Shopping
+# v0.25 - Window Shopping
 
 ![](./v0.25/banner.png)
 
 ## Windows
 
-Support for volume prefix in path completion.
\ No newline at end of file
+Support for volume prefix in path completion.
diff --git a/docs/src/release_notes/v0.29.md b/docs/src/release_notes/v0.29.md
index 35b3369151..68a174c401 100644
--- a/docs/src/release_notes/v0.29.md
+++ b/docs/src/release_notes/v0.29.md
@@ -2,17 +2,26 @@
 
 ![](./v0.29/banner.png)
 
-## Macros
+One step further to exchange completions (loosely coupled) between commands.
+
+## Root Command
+
+Restructured the root command which was (and still is) a bit of a mess.
+Some "flags" (subcommands) were renamed/changed for consistency.
+
+- `--list=json` -> `--list --format json`
+- `--scrape [spec]` -> `--codegen [spec]`
+
+## Macro
 
 `$_` prefix is now deprecated and needs to be replaced with `$carapace.`
 
 ```
-$_color.HexColors
 $carapace.color.HexColors
-```
+# invokes `carapace _carapace macro color.HexColors ""`
 
-```sh
-carapace _carapace macro color.HexColors ""
+$carapace-spec.Spec(example.yaml)
+# invokes `carapace-spec _carapace macro "Spec(example.yaml)" ""`
 ```
 
 ```sh