Skip to content

Commit 0c9c2f0

Browse files
docs(audit): tier 6 — 'blocklist' (block list UI) → 'block list' to disambiguate (#109)
The style_lint rule 'blocklist → denylist' (per AGENTS.md allowlist/denylist guidance) was firing on 'blocklist' references that actually mean the terminal's *block list* (the UI panel listing command blocks). That's a distinct concept from the allowlist/denylist style rule. Fixed by spacing 'blocklist' → 'block list' (two words) so the prose is unambiguous to both readers and the linter: * full-terminal-use.mdx (2x) * blocks-as-context.mdx (3x) * conversation-forking.mdx * local-agents/interacting-with-agents/index.mdx (2x) * terminal-and-agent-modes.mdx (3x) * more-features/full-screen-apps.mdx (2x) * more-features/text-selection.mdx ## Intentionally skipped (literal UI feature names / image asset) Need product verification before changing these; left as-is so prose stays accurate to the in-app UI labels: * terminal/warpify/subshells.mdx:44,46 — 'Blocklisting commands' / 'add commands to the Blocklist' (Warpify denylist feature) * privacy.mdx:85,87 — 'in the AI blocklist' (AI rule denylist UI) * secret-redaction.mdx:22 — 'Hide secrets in blocklist' setting (Settings > Privacy > Secret redaction > <literal toggle name>) * code/code-review.mdx:53 — image filename 'Blocklist-with-review-changes.png' (renaming the asset is a separate effort with git history considerations) Validation: 0 broken links / 2577 internal, lint clears 12 DEPRECATED-TERM warnings (19 → 7 remaining, all in the skipped-by-design category), 332 pages build clean. Co-authored-by: Oz <oz-agent@warp.dev>
1 parent fbe224b commit 0c9c2f0

7 files changed

Lines changed: 14 additions & 14 deletions

File tree

src/content/docs/agent-platform/capabilities/full-terminal-use.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -107,14 +107,14 @@ The behavior differs based on where you start the long-running command:
107107
1. Run an interactive command (e.g., `python`, `psql`)
108108
2. Press `⌘↩` (macOS) or `Ctrl+Shift+Enter` (Windows/Linux), or use `⌘I` (macOS) / `Ctrl+I` (Windows/Linux), to tag in the agent
109109
3. The input switches to Agent Mode with full controls
110-
4. When you exit, an agent conversation block appears in your terminal blocklist
110+
4. When you exit, an agent conversation block appears in your terminal block list
111111
5. Click the block to reopen the full conversation with your LRC interaction context
112112
</TabItem>
113113
<TabItem label="From agent view">
114114
1. The agent runs an interactive command as part of your conversation
115115
2. Use `⌘↩` (macOS) or `Ctrl+Shift+Enter` (Windows/Linux) to tag in if the agent isn't already interacting
116116
3. The UI stays the same since you're already in agent view
117-
4. When you exit, the interaction remains part of your conversation. No separate block is created in the terminal blocklist
117+
4. When you exit, the interaction remains part of your conversation. No separate block is created in the terminal block list
118118
5. Commands run in agent view are automatically included as context
119119
</TabItem>
120120
</Tabs>

src/content/docs/agent-platform/local-agents/agent-context/blocks-as-context.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Attach terminal output blocks to your agent prompts so the agent can understand
1212

1313
Warp’s Agent can use blocks from your Agent conversations as context to better understand your queries and generate more relevant responses.
1414

15-
You can attach a block directly from the terminal blocklist by clicking the AI sparkles icon on it and selecting “Attach as context.”
15+
You can attach a block directly from the terminal block list by clicking the AI sparkles icon on it and selecting “Attach as context.”
1616

1717
<figure>
1818
![From a block of output, attach the block and ask Agent Mode to remove all untracked files.](../../../../../assets/agent-platform/remove_all_untracked_files.png)
@@ -77,8 +77,8 @@ The most common use case is to ask the AI to fix an error. You can attach the er
7777

7878
Blocks in Warp belong to either the terminal view or a specific agent conversation:
7979

80-
* **Terminal blocks** - Commands you run directly in the terminal. These always appear in your terminal blocklist and can be attached as context to multiple conversations.
81-
* **Agent conversation blocks** - Commands executed within an agent conversation (either by you or the agent). These only appear within that specific conversation and don't clutter your terminal blocklist.
80+
* **Terminal blocks** - Commands you run directly in the terminal. These always appear in your terminal block list and can be attached as context to multiple conversations.
81+
* **Agent conversation blocks** - Commands executed within an agent conversation (either by you or the agent). These only appear within that specific conversation and don't clutter your terminal block list.
8282

8383
This separation keeps your terminal view clean while preserving full context within each conversation.
8484

src/content/docs/agent-platform/local-agents/interacting-with-agents/conversation-forking.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ You can also access this conversation view from the conversation chip in the cur
4141

4242
#### **2. From the footer of the most recent AI response block**
4343

44-
In any conversation in the blocklist, click the **fork button** in the footer of the most recent AI block. A new conversation opens in a separate pane with the full context of the original.
44+
In any conversation in the block list, click the **fork button** in the footer of the most recent AI block. A new conversation opens in a separate pane with the full context of the original.
4545

4646
![Fork conversation button in the footer of the most recent agent response block](../../../../../assets/agent-platform/conversation-forking-footer.png)
4747

src/content/docs/agent-platform/local-agents/interacting-with-agents/index.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -142,9 +142,9 @@ If you switch models during a conversation, the context usage indicator updates
142142

143143
Warp automatically detects when your query has shifted to a new topic. When this happens, it suggests starting a new conversation instead of continuing in the same context.
144144

145-
These options appear in the blocklist, where you can decide whether to branch off into a new conversation or keep going with the current one.
145+
These options appear in the block list, where you can decide whether to branch off into a new conversation or keep going with the current one.
146146

147-
![Suggestion in the blocklist to start a new conversation when Warp detects a topic shift.](../../../../../assets/agent-platform/conversation-segmentation.png)
147+
![Suggestion in the block list to start a new conversation when Warp detects a topic shift.](../../../../../assets/agent-platform/conversation-segmentation.png)
148148

149149
You can also create a new conversation manually at any time by using the keyboard shortcut, opening a new tab, or opening a new pane.
150150

src/content/docs/agent-platform/local-agents/interacting-with-agents/terminal-and-agent-modes.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -98,14 +98,14 @@ Agent Mode-specific items include the model selector, autodetection toggle, Cont
9898

9999
Blocks in Warp belong to either the terminal view or a specific agent conversation:
100100

101-
* **Terminal blocks** - Commands you run directly in the terminal always appear in your terminal blocklist and can be attached as context to any conversation.
102-
* **Agent conversation blocks** - Commands executed within an agent conversation (either by you or the agent) only appear within that specific conversation and don't appear in the terminal blocklist.
101+
* **Terminal blocks** - Commands you run directly in the terminal always appear in your terminal block list and can be attached as context to any conversation.
102+
* **Agent conversation blocks** - Commands executed within an agent conversation (either by you or the agent) only appear within that specific conversation and don't appear in the terminal block list.
103103

104104
In agent conversations, context is managed automatically, with optional manual attachment from terminal view:
105105

106106
* **Automatic context** - Commands executed within an agent conversation are included as context for subsequent prompts.
107107
* **Manual attachment** - You can attach terminal blocks to bring in outputs from outside the conversation.
108-
* **Conversation scope** - Agent conversation blocks stay scoped to that conversation, while terminal blocks remain in the terminal blocklist.
108+
* **Conversation scope** - Agent conversation blocks stay scoped to that conversation, while terminal blocks remain in the terminal block list.
109109

110110
This separation keeps your terminal view clean while preserving full context within each conversation. For shortcuts, pending vs. attached context, and block selection behavior, see [Blocks as Context](/agent-platform/local-agents/agent-context/blocks-as-context/).
111111

src/content/docs/terminal/more-features/full-screen-apps.mdx

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -33,7 +33,7 @@ If you want a mouse event to go to Warp instead (for example, for text selection
3333

3434
## Padding
3535

36-
Warp supports configuring how much padding surrounds full-screen apps. The default is 0 pixel padding, but this can be changed to a custom padding amount or to match the padding in the Blocklist.
36+
Warp supports configuring how much padding surrounds full-screen apps. The default is 0 pixel padding, but this can be changed to a custom padding amount or to match the padding in the block list.
3737

3838
:::note
3939
Warp allows you to scale your terminal by fractions of a cell width | height. When your terminal size is not perfectly aligned to a cell width | height, the extra space appears as padding on the right | bottom.
@@ -42,7 +42,7 @@ Warp allows you to scale your terminal by fractions of a cell width | height. Wh
4242
### How to access it
4343

4444
* Go to **Settings** > **Appearance** > **Full-screen Apps** or from the [Command Palette](/terminal/command-palette/) search for "Appearance"
45-
* `Use custom padding in alt-screen` is enabled by default, you can disable it to match the Blocklist padding
45+
* `Use custom padding in alt-screen` is enabled by default, you can disable it to match the block list padding
4646
* Set the desired uniform padding (px) pixels, which is set to 0px by default
4747

4848
:::caution

src/content/docs/terminal/more-features/text-selection.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ description: >-
1414
<figcaption>Using smart selection to select a file path by double clicking.</figcaption>
1515
</figure>
1616

17-
Double-click on text in the input or blocklist. The following patterns are recognized:
17+
Double-click on text in the input or block list. The following patterns are recognized:
1818

1919
1. URLs
2020
2. File paths

0 commit comments

Comments
 (0)