tmp

Author: rsteube

docs/src/freckles/cmd/add.md

@@ -1,6 +1,6 @@
 # Add
 
-This copies a dotfile to the repository and replaces it with a symlink.
+Copies a dotfile to the repository and replaces it with a symlink.
 
 ```go
 {{#include ../../../../cmd/freckles/cmd/add.go:cmd}}
@@ -23,7 +23,6 @@ Completion is provided with [ActionFiles] using a couple of twists.
 >
 > [Batch] not only enables concurrent invokation of [Actions].
 > It also provides a neat way to add them **conditionally**.
->
 > See [ActionRefs] for a more sophisticated example.
 
 [Actions]:https://carapace-sh.github.io/carapace/carapace/action.html

docs/src/freckles/cmd/edit.md

@@ -1,9 +1,13 @@
 # Edit
 
+Opens a dotfile in your editor.
+
 ```go
 {{#include ../../../../cmd/freckles/cmd/edit.go:cmd}}
 ```
 
+Completion is provided with a [custom action].
+
 ```go
 {{#include ../../../../cmd/freckles/cmd/edit.go:positional}}
 ```
@@ -13,5 +17,14 @@
 {{#include ../../../../cmd/freckles/cmd/action/freckle.go}}
 ```
 
-> There are **two major phases** in [Carapace]. 
+> There are **two major phases** in [Carapace]:
+> 1. The creation of the command structure and registration of completions.
+> 2. The invocation of the [Action] corresponding to current position.
 >
+> [Custom Actions] should almost always be wrapped in [ActionCallback]
+
+[Action]:https://carapace-sh.github.io/carapace/carapace/action.html
+[ActionCallback]:https://carapace-sh.github.io/carapace/carapace/defaultActions/actionCallback.html
+[Carapace]:https://carapace.sh
+[Custom Actions]:https://carapace-sh.github.io/carapace/carapace/customActions.html
+[custom action]:https://carapace-sh.github.io/carapace/carapace/customActions.html

docs/src/freckles/cmd/init.md

@@ -1,8 +1,6 @@
 # Init
 
-[Freckles] is backed by a [Git] repository located at `~/.local/share/freckles`.
-
-With `init` a new one is created.
+Creates a new [Git] repository at `~/.local/share/freckles`.
 
 ```go
 {{#include ../../../../cmd/freckles/cmd/init.go:cmd}}
@@ -56,12 +54,8 @@ Completion is provided by [ActionRepositorySearch].
 >
 > Note that for performance reasons only the first 100 search results are presented.
 > Fast response times are important which limits what can be done in [Carapace].
->
-> [Tabdance] will provide a solution for this in the future.
 
 [ActionRepositorySearch]:https://pkg.go.dev/github.com/carapace-sh/carapace-bin/pkg/actions/tools/git#ActionRepositorySearch
 [Actions]:https://carapace-sh.github.io/carapace/carapace/action.html
 [Carapace]:https://carapace.sh
-[Freckles]:https://github.com/rsteube/freckles
 [Git]:https://git-scm.com/
-[Tabdance]:https://tab.dance