Skip to content

Commit 9e74429

Browse files
docs(factories): use root-absolute links on filters page and cross-links
Align the new automation-filters page and its jira.mdx cross-link with the root-absolute link convention adopted on hyc/factory-launch in #550. Co-Authored-By: Warp <agent@warp.dev>
1 parent a94b420 commit 9e74429

2 files changed

Lines changed: 12 additions & 12 deletions

File tree

src/content/docs/factories/automation-filters.mdx

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ sidebar:
88
topic: factories
99
---
1010

11-
Automation filters decide which events from your connected tools start factory work. Every trigger on a [factory automation](./connect-your-factory) carries filters — conditions such as a repository, channel, team, project, label, or author — and an event starts a run only when it matches them. Filters let a factory watch busy channels and repositories without acting on everything in them.
11+
Automation filters decide which events from your connected tools start factory work. Every trigger on a [factory automation](/factories/connect-your-factory/) carries filters — conditions such as a repository, channel, team, project, label, or author — and an event starts a run only when it matches them. Filters let a factory watch busy channels and repositories without acting on everything in them.
1212

1313
## How matching works
1414

@@ -30,15 +30,15 @@ Filters are still your main control over who starts runs. On GitHub and GitLab,
3030

3131
Every source filters on where the event happened — a repository, project, conversation, or team. The remaining filters vary by source and event type:
3232

33-
{/* TODO: link the GitLab row to ./integrations/gitlab once the GitLab integration page lands (PR #549). */}
33+
{/* TODO: link the GitLab row to /factories/integrations/gitlab/ once the GitLab integration page lands (PR #549). */}
3434

3535
| Source | Filters |
3636
| --- | --- |
37-
| [Slack](./integrations/slack) | Conversations, authors or members, keywords, emoji, and reacted-message authors |
38-
| [GitHub](./integrations/github) | Repository, branches, base branches, paths, labels, authors, assignees, mentioned users or teams, reviewers, review states, workflows, and conclusions |
37+
| [Slack](/factories/integrations/slack/) | Conversations, authors or members, keywords, emoji, and reacted-message authors |
38+
| [GitHub](/factories/integrations/github/) | Repository, branches, base branches, paths, labels, authors, assignees, mentioned users or teams, reviewers, review states, workflows, and conclusions |
3939
| GitLab | Project, actions, and base branch |
40-
| [Linear](./integrations/linear) | Teams, labels, project, workflow state, assignee, mentioned user, and, for comment events, a specific issue |
41-
| [Jira](./integrations/jira) | Jira projects and assignment keywords |
40+
| [Linear](/factories/integrations/linear/) | Teams, labels, project, workflow state, assignee, mentioned user, and, for comment events, a specific issue |
41+
| [Jira](/factories/integrations/jira/) | Jira projects and assignment keywords |
4242

4343
Each integration guide lists which filters appear on which event types.
4444

@@ -52,7 +52,7 @@ Review the default automations Warp creates when you connect a provider, too: th
5252

5353
## Filters in definitions as code
5454

55-
In a [factory definition](./factory-as-code), each entry under an automation's `triggers` takes an optional `filter` whose keys mirror the filters in the automation editor:
55+
In a [factory definition](/factories/factory-as-code/), each entry under an automation's `triggers` takes an optional `filter` whose keys mirror the filters in the automation editor:
5656

5757
```markdown title="automations/labeled-issue/automation.md"
5858
---
@@ -77,7 +77,7 @@ The same matching rules apply: every key must match, any listed value within a k
7777

7878
## Related pages
7979

80-
* [Connect your factory](./connect-your-factory) - Choose the sources that route work into the factory.
81-
* [Slack](./integrations/slack), [GitHub](./integrations/github), [Linear](./integrations/linear), and [Jira](./integrations/jira) integration guides - Per-source setup, events, and filter details.
82-
* [Definitions as code](./factory-as-code) - Manage automations, triggers, and filters as version-controlled files.
83-
* [Control room](./control-room) - Create and edit automations in the factory's **Automations** view.
80+
* [Connect your factory](/factories/connect-your-factory/) - Choose the sources that route work into the factory.
81+
* [Slack](/factories/integrations/slack/), [GitHub](/factories/integrations/github/), [Linear](/factories/integrations/linear/), and [Jira](/factories/integrations/jira/) integration guides - Per-source setup, events, and filter details.
82+
* [Definitions as code](/factories/factory-as-code/) - Manage automations, triggers, and filters as version-controlled files.
83+
* [Control room](/factories/control-room/) - Create and edit automations in the factory's **Automations** view.

src/content/docs/factories/integrations/jira.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,7 @@ All Jira work reaches the factory through a single event, `agent_session_created
6060
* **`project_keys`** - Match work items in these Jira projects.
6161
* **`keywords`** - Match assignment text that contains any of these words. Matching is case-insensitive.
6262

63-
A session must match every field you set; within a field, any listed value is a match. Omit a field to match everything. For the matching rules shared by every source, see [automation filters](../automation-filters).
63+
A session must match every field you set; within a field, any listed value is a match. Omit a field to match everything. For the matching rules shared by every source, see [automation filters](/factories/automation-filters/).
6464

6565
:::caution
6666
Filters like `project_keys` decide whether *your* automation starts a run; they aren't an access boundary. A Jira event is evaluated against every team's automations in the connected workspace, so another team's automation with a broader or different filter can still start its own run on the same work item. Installing the Warp app doesn't scope its Jira access to specific projects either — scoping Jira project access by Warp team is coming soon.

0 commit comments

Comments
 (0)