> ## Documentation Index
> Fetch the complete documentation index at: https://docs.docwriter.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Selected text and directives

> Give feedback at a passage or leave an instruction in the draft.

## Give feedback on selected text

Select text to open the feedback popup. Enter a request or choose a recent action. Press **Enter** or click **Go** to send it.

**Direct edit** asks the agent to change the selected passage. **Plan first** asks the agent to explain the planned change in the thread before editing. The **AI smell** quick action always plans first.

The popup also contains **Locate in PDF** when a matching preview exists.

<Frame>
  <img src="https://mintcdn.com/ucberkeley-8d9be701/_cooIo6pWvrP0otR/images/inline-feedback-popup.png?fit=max&auto=format&n=_cooIo6pWvrP0otR&q=85&s=66cfbcc3c6d205fee1eb8a9fa5d99ada" alt="The selected text feedback popup with direct edit and plan first controls" width="1400" height="900" data-path="images/inline-feedback-popup.png" />
</Frame>

## Freeze a passage

Choose **Freeze for agent** to create a rule that protects the selected text. A lock appears beside the passage. Click the lock and choose **Unlock, allow agent to edit** when the passage can change again.

<Frame>
  <img src="https://mintcdn.com/ucberkeley-8d9be701/v3Rddkad7zEz0_aI/images/freeze-selection-popup.png?fit=max&auto=format&n=v3Rddkad7zEz0_aI&q=85&s=22c0e447074de17dbc3c5c4806bdd774" alt="The Freeze for agent action for selected text" width="1400" height="900" data-path="images/freeze-selection-popup.png" />
</Frame>

## Leave an inline directive

Place an instruction inside one of the following delimiter pairs:

```md theme={null}
[[ add a source for this claim ]]
(( shorten this example ))
<< check the numbers >>
```

The agent treats a directive as an explicit request. It should handle the request and remove the directive text in the same edit. The server can start one retry pass when the agent ignores a directive.

Directives remain ordinary document text until an edit removes them.

<Frame>
  <img src="https://mintcdn.com/ucberkeley-8d9be701/_cooIo6pWvrP0otR/images/inline-directives-in-doc.png?fit=max&auto=format&n=_cooIo6pWvrP0otR&q=85&s=51c9c16f30f67be8a02f33f7dcc67992" alt="An inline directive written directly in the source document" width="1400" height="900" data-path="images/inline-directives-in-doc.png" />
</Frame>
