Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

Refactor: simplify wording in documentation and error messages

Maximilian Roos6eaeb032ac9a
diff --git a/.claude-plugin/skills/worktrunk/reference/hook.md b/.claude-plugin/skills/worktrunk/reference/hook.md
index ccbe1e916..11130a580 100644
--- a/.claude-plugin/skills/worktrunk/reference/hook.md
+++ b/.claude-plugin/skills/worktrunk/reference/hook.md
@@ -196,9 +196,9 @@ Both run when creating a worktree. The difference:
| Hook | Execution | Best for |
|------|-----------|----------|
| `post-create` | Blocks until complete | Tasks the developer needs before working (dependency install) |
-| `post-start` | Background, parallel | Long-running tasks that can finish while you work |
+| `post-start` | Background, parallel | Long-running tasks that can finish in parallel |
-Many tasks work well in `post-start` — they'll likely be ready by the time you need them, especially when the fallback is recompiling. If unsure, prefer `post-start` for faster worktree creation.
+Many tasks work well in `post-start` — they'll likely be ready by the time they're needed, especially when the fallback is recompiling. If unsure, prefer `post-start` for faster worktree creation.
### Copying untracked files
@@ -216,7 +216,7 @@ Use `wt step copy-ignored` to copy files listed in `.worktreeinclude` that are a
copy = "wt step copy-ignored"
```
-Create a `.worktreeinclude` file in your repository root listing patterns to copy (uses gitignore syntax):
+Create a `.worktreeinclude` file in the repository root listing patterns to copy (uses gitignore syntax):
```gitignore
# .worktreeinclude
diff --git a/docs/content/hook.md b/docs/content/hook.md
index 768a1d99d..dd70da8c1 100644
--- a/docs/content/hook.md
+++ b/docs/content/hook.md
@@ -204,9 +204,9 @@ Both run when creating a worktree. The difference:
| Hook | Execution | Best for |
|------|-----------|----------|
| `post-create` | Blocks until complete | Tasks the developer needs before working (dependency install) |
-| `post-start` | Background, parallel | Long-running tasks that can finish while you work |
+| `post-start` | Background, parallel | Long-running tasks that can finish in parallel |
-Many tasks work well in `post-start` — they'll likely be ready by the time you need them, especially when the fallback is recompiling. If unsure, prefer `post-start` for faster worktree creation.
+Many tasks work well in `post-start` — they'll likely be ready by the time they're needed, especially when the fallback is recompiling. If unsure, prefer `post-start` for faster worktree creation.
### Copying untracked files
@@ -224,7 +224,7 @@ Use `wt step copy-ignored` to copy files listed in `.worktreeinclude` that are a
copy = "wt step copy-ignored"
```
-Create a `.worktreeinclude` file in your repository root listing patterns to copy (uses gitignore syntax):
+Create a `.worktreeinclude` file in the repository root listing patterns to copy (uses gitignore syntax):
```gitignore
# .worktreeinclude
diff --git a/src/cli/mod.rs b/src/cli/mod.rs
index ca8a801a4..f260d7345 100644
--- a/src/cli/mod.rs
+++ b/src/cli/mod.rs
@@ -1186,9 +1186,9 @@ Both run when creating a worktree. The difference:
| Hook | Execution | Best for |
|------|-----------|----------|
| `post-create` | Blocks until complete | Tasks the developer needs before working (dependency install) |
-| `post-start` | Background, parallel | Long-running tasks that can finish while you work |
+| `post-start` | Background, parallel | Long-running tasks that can finish in parallel |
-Many tasks work well in `post-start` — they'll likely be ready by the time you need them, especially when the fallback is recompiling. If unsure, prefer `post-start` for faster worktree creation.
+Many tasks work well in `post-start` — they'll likely be ready by the time they're needed, especially when the fallback is recompiling. If unsure, prefer `post-start` for faster worktree creation.
### Copying untracked files
@@ -1206,7 +1206,7 @@ Use `wt step copy-ignored` to copy files listed in `.worktreeinclude` that are a
copy = "wt step copy-ignored"
```
-Create a `.worktreeinclude` file in your repository root listing patterns to copy (uses gitignore syntax):
+Create a `.worktreeinclude` file in the repository root listing patterns to copy (uses gitignore syntax):
```gitignore
# .worktreeinclude
diff --git a/src/llm.rs b/src/llm.rs
index f0a695d3a..db545998a 100644
--- a/src/llm.rs
+++ b/src/llm.rs
@@ -336,7 +336,7 @@ fn load_template(
"{}",
warning_message(format!(
"{} is deprecated and will be removed in a future release. \
- Use inline template instead. If you need this feature, comment on: \
+ Use inline template instead. To request this feature, comment on: \
https://github.com/max-sixty/worktrunk/issues/444",
file_type_name
))