Skip to content

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

fix: render [experimental] badge in Aliases section of step docs (#1729)

Maximilian Roosfc0ee3a5f7c9
diff --git a/docs/content/step.md b/docs/content/step.md
index 2c5b5a984..d2dc59f22 100644
--- a/docs/content/step.md
+++ b/docs/content/step.md
@@ -844,7 +844,7 @@ Usage: <b><span class=c>wt step relocate</span></b> <span class=c>[OPTIONS]</spa
## Aliases
-[experimental] Custom command templates configured in user config (`~/.config/worktrunk/config.toml`) or project config (`.config/wt.toml`). Aliases support the same [template variables](@/hook.md#template-variables) as hooks.
+<span class="badge-experimental"></span> Custom command templates configured in user config (`~/.config/worktrunk/config.toml`) or project config (`.config/wt.toml`). Aliases support the same [template variables](@/hook.md#template-variables) as hooks.
```toml
# .config/wt.toml
diff --git a/src/help.rs b/src/help.rs
index f2624eeda..a1b5d8182 100644
--- a/src/help.rs
+++ b/src/help.rs
@@ -403,10 +403,13 @@ Commands with pages: merge, switch, remove, list"
std::println!("```");
// Subdocs follow, each with their own command reference at the end.
- // post_process_for_html is already applied inside format_subcommand_section,
- // so we don't apply it again here (it would corrupt HTML inside reference blocks).
if let Some(subdocs) = subdoc_content {
- let subdocs_expanded = expand_subdoc_placeholders(subdocs, sub, &parent_name);
+ // Apply post-processing to non-marker text (e.g., the Aliases section after
+ // the last subdoc marker). Must happen before expansion — after expansion,
+ // post_process_for_html has already run on each subcommand section internally
+ // (in format_subcommand_section), so re-running it would double-convert.
+ let subdocs = post_process_for_html(subdocs);
+ let subdocs_expanded = expand_subdoc_placeholders(&subdocs, sub, &parent_name);
std::println!();
std::println!("# Subcommands");
std::println!();