tmp

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.
+Support for volume prefix in path completion.

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