From 36dbeb194312dbb1d384e397d57a33fb6d02426b Mon Sep 17 00:00:00 2001 From: Mohamed Boudra Date: Fri, 20 Nov 2026 17:31:13 +0100 Subject: [PATCH] docs(hub): clarify trigger authoring and event limits --- public-docs/hub/configuration/reference.md | 10 ++++++++-- public-docs/hub/configuration/reference.zh-CN.md | 10 ++++++++-- public-docs/hub/faq.md | 6 ++++-- public-docs/hub/faq.zh-CN.md | 6 ++++-- public-docs/hub/quickstart.md | 4 +++- public-docs/hub/quickstart.zh-CN.md | 4 +++- public-docs/hub/triggers/discord.md | 4 +++- public-docs/hub/triggers/discord.zh-CN.md | 4 +++- public-docs/hub/triggers/index.md | 8 ++++++-- public-docs/hub/triggers/index.zh-CN.md | 8 ++++++-- public-docs/hub/triggers/slack.md | 2 +- public-docs/hub/triggers/slack.zh-CN.md | 2 +- 12 files changed, 50 insertions(+), 18 deletions(-) diff --git a/public-docs/hub/configuration/reference.md b/public-docs/hub/configuration/reference.md index a9093d0c6d..6755a66698 100644 --- a/public-docs/hub/configuration/reference.md +++ b/public-docs/hub/configuration/reference.md @@ -39,9 +39,11 @@ One trigger document can list more than one event under `on`. The dashboard visu | Field | Required | Notes | | ---------- | -------- | ------------------------------------------------------------------------------ | | `daemon` | yes | Connected daemon slug with `hub.execute` permission. | -| `cwd` | yes | Existing absolute path on that daemon. | +| `cwd` | yes | Existing directory on that daemon, with an absolute path that starts with `/`. | | `worktree` | no | Optional git worktree mode: `branch-off`, `checkout-branch`, or `checkout-pr`. | +For example, `/home/me/project` uses the required path format. Hub rejects Windows drive paths such as `C:\work\project`. + Worktree modes: - `branch-off`: requires `newBranch` and optional `base`. Embed `${{ paseo.execution.id }}` in `newBranch` (for example `trigger-${{ paseo.execution.id }}`) so each execution gets a unique branch that survives retries. `${{ paseo.execution.id }}` is the only expression accepted in `newBranch`. @@ -129,7 +131,11 @@ Wrap untrusted external text in a clear delimiter such as `...