tmp

Author: rsteube

docs/src/freckles/cmd/root.md

@@ -11,7 +11,8 @@
 > This can be prevented with [`CompletionOptions`].
 >
 > Historically [Cobra] had no dynamic completion and development in this regard was quite stale.
-> Without the burden of backward compability and the massive amount of [dependents], [Carapace] could develop much more quickly.
+> Without the burden of backward compability and the massive amount of [dependents],
+> [Carapace] could develop much more quickly and push the boundary of what's possible.
 >
 > Here's the [cornerstone] which ultimately became [Carapace].
 
@@ -34,14 +35,23 @@ Most of these can be directly sourced.
 
 ![](./root/script.cast)
 
-> [Carapace] has a basic shell detection mechanism, so in most cases `[shell]` is optional.
+> [Carapace] has a basic [shell detection] mechanism, so in most cases `[shell]` is optional.
 
 ## Export
 
 Shell scripts in [Carapace] are just thin layers to integrate with the corresponding shell.
 
-Aside from shell specific output (`freckles _carapace [shell] freckles ...[ARGS]`) which simplifies the shell scripts.
-[Export] provides a more generic `json` representation of completions.
+Aside from shell specific output (which simplifies the scripts):
+
+```sh
+freckles _carapace [shell] freckles ...[ARGS]  
+```
+
+[Export] provides a more generic `json` representation of completions:
+
+```sh
+freckles _carapace export freckles ...[ARGS]  
+```
 
 -
 -
@@ -74,3 +84,4 @@ Aside from shell specific output (`freckles _carapace [shell] freckles ...[ARGS]
 [MacroN]:https://pkg.go.dev/github.com/carapace-sh/carapace-spec#MacroN
 [Macros]:https://carapace-sh.github.io/carapace-spec/carapace-spec/macros.html
 [MacroV]:https://pkg.go.dev/github.com/carapace-sh/carapace-spec#MacroV
+[shell detection]:https://github.com/carapace-sh/carapace/blob/master/pkg/ps/ps.go