zed/docs/src
morgankrey 9adb3e1daa
docs: Testing automatic documentation updates locally (2025-12-21) (#45503)
## Documentation Update Summary

### Changes Made

| File | Change | Related Code |
| --- | --- | --- |
| `docs/src/ai/edit-prediction.md` | Updated Codestral setup
instructions to use Settings Editor path instead of outdated
`agent::OpenSettings` action reference | Settings Editor provider
configuration flow |

### Rationale

The primary documentation update addresses outdated instructions in the
Codestral setup section. The original text referenced an
`agent::OpenSettings` action that directed users to an "Agent Panel
settings view" which no longer reflects the current UI flow. The updated
instructions now guide users through the Settings Editor with
platform-specific keyboard shortcuts and provide an alternative status
bar path.

### Review Notes

- **Codestral instructions**: Reviewers should verify the Settings
Editor navigation path (`Cmd+,` → search "Edit Predictions" →
**Configure Providers**) matches the current Zed UI
- **Status bar alternative**: The alternative path via "edit prediction
icon in the status bar" should be confirmed as accurate

---

## Update from 2025-12-21 20:25

---
**Source**: [#44914](https://github.com/zed-industries/zed/pull/44914) -
settings_ui: Add Edit keybindings button
**Author**: @probably-neb

Now I have all the context needed to create a comprehensive
documentation update summary.

## Documentation Update Summary

### Changes Made
| File | Change | Related Code |
| --- | --- | --- |
| docs/src/ai/agent-panel.md | Added documentation for `agent::PasteRaw`
action, explaining automatic @mention formatting for pasted code and how
to bypass it | PR #45254 |

### Rationale
PR #45254 ("agent_ui: Improve UX when pasting code into message editor")
introduced the `agent::PasteRaw` action, which allows users to paste
clipboard content without automatic formatting. When users copy
multi-line code from an editor buffer and paste it into the Agent panel,
Zed now automatically formats it as an @mention with file context. The
`PasteRaw` action provides a way to bypass this behavior when raw text
is preferred.

This documentation update ensures users can discover both:
1. The new automatic @mention formatting behavior
2. The keybinding to bypass it when needed

### Review Notes
- The new paragraph was placed in the "Adding Context" section,
immediately after the existing note about image pasting support—this
maintains logical flow since both relate to pasting behavior
- Uses the standard `{#kb agent::PasteRaw}` syntax for keybinding
references, consistent with other keybinding documentation in the file
- The documentation passed Prettier formatting validation without
modifications

---

### Condensed Version (for commit message)
```
docs(agent-panel): Document PasteRaw action for bypassing auto @mention formatting

Added explanation that multi-line code pasted from editor buffers is
automatically formatted as @mentions, with keybinding to paste raw text.

Related: PR #45254
```

Release Notes:

- N/A

---------

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
Co-authored-by: Zed Zippy <234243425+zed-zippy[bot]@users.noreply.github.com>
2025-12-21 20:31:24 -06:00
..
ai docs: Testing automatic documentation updates locally (2025-12-21) (#45503) 2025-12-21 20:31:24 -06:00
collaboration More tweaks to collaboration docs (#43494) 2025-11-25 22:08:39 +00:00
development docs: Remove local collaboration docs (#45301) 2025-12-18 21:42:28 +00:00
extensions docs: Improve documentation for updating an extension (#44475) 2025-12-09 11:49:33 +00:00
languages editor: Add automatic markdown list continuation on newline and indent on tab (#42800) 2025-12-19 21:44:02 +05:30
migrate docs: Add migrate docs for Webstorm / Pycharm / RustRover (#45128) 2025-12-17 08:44:48 -08:00
all-actions.md docs: Add sidebar title collapse functionality and design facelift (#43754) 2025-11-28 17:36:50 -03:00
authentication.md Restructure collaboration docs (#43464) 2025-11-25 10:53:47 -05:00
command-line-interface.md docs: Reorganize introduction (#41387) 2025-10-28 17:39:40 -03:00
command-palette.md docs: Reorganize introduction (#41387) 2025-10-28 17:39:40 -03:00
completions.md docs: Add note about conflicting global macOS shortcut (#45186) 2025-12-18 02:13:59 +00:00
configuring-languages.md docs: Add sidebar title collapse functionality and design facelift (#43754) 2025-11-28 17:36:50 -03:00
configuring-zed.md editor: Add automatic markdown list continuation on newline and indent on tab (#42800) 2025-12-19 21:44:02 +05:30
debugger.md Update documentation on Java support (#41758) 2025-11-05 12:24:29 +01:00
dev-containers.md docs: Dev container (#44498) 2025-12-17 08:28:32 -08:00
development.md docs: Remove local collaboration docs (#45301) 2025-12-18 21:42:28 +00:00
diagnostics.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
environment.md docs: Fix typo in environment documentation (#19164) 2024-10-13 16:47:09 -04:00
extensions.md docs: Add docs on extension capabilities (#42223) 2025-11-07 18:38:20 +00:00
getting-started.md docs: Reorganize introduction (#41387) 2025-10-28 17:39:40 -03:00
git.md docs: Drop deprecated key from settings for Agent Panel (#44923) 2025-12-15 17:04:03 -05:00
globs.md typo: Use tips from proselint (#42362) 2025-11-10 17:51:44 +02:00
helix.md helix: Add match operator (#34060) 2025-09-08 08:48:47 -06:00
icon-themes.md docs: Update theme, icon theme, and visual customization pages (#41761) 2025-11-02 14:30:37 -03:00
installation.md docs: Add documentation for installing via winget (#44941) 2025-12-16 09:13:48 +01:00
key-bindings.md Update docs to use == instead of = (#41415) 2025-10-28 19:34:19 -06:00
languages.md docs: Add Yara language extension (#28693) 2025-04-14 12:40:13 -04:00
linux.md docs: Add Conda package to Linux community-maintained packages list (#44029) 2025-12-02 22:44:22 +00:00
multibuffers.md Fix a typo in the multi buffers documentation (#18535) 2024-09-30 15:28:46 +03:00
outline-panel.md docs: Add tweaks to the outline panel page (#18697) 2024-10-03 12:27:42 -03:00
performance.md Put tracy dependency behind feature tracy (#44277) 2025-12-06 14:08:01 +02:00
quick-start.md docs: Reorganize introduction (#41387) 2025-10-28 17:39:40 -03:00
remote-development.md Update version example in remote-development.md (#45427) 2025-12-20 05:51:22 +00:00
repl.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
snippets.md docs: Fix small typo in docs for Snippets (#43238) 2025-11-21 06:56:47 -05:00
SUMMARY.md docs: Remove local collaboration docs (#45301) 2025-12-18 21:42:28 +00:00
tab-switcher.md tab_switcher: Add documentation for tab switcher (#44189) 2025-12-05 18:18:51 +00:00
tasks.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
telemetry.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
themes.md Support bracket colorization (rainbow brackets) (#43172) 2025-11-20 19:47:39 +00:00
toolchains.md Restructure collaboration docs (#43464) 2025-11-25 10:53:47 -05:00
troubleshooting.md Add more tweaks to the troubleshooting docs (#40870) 2025-10-22 09:04:05 +00:00
uninstall.md docs: Fix broken links in docs with lychee (#42404) 2025-11-11 13:55:02 +01:00
update.md docs: Reorganize introduction (#41387) 2025-10-28 17:39:40 -03:00
vim.md docs: Add clarifying note about Vim subword motion (#44535) 2025-12-14 02:20:33 -05:00
visual-customization.md Add setting to hide user menu in the title bar (#44466) 2025-12-15 12:25:17 +00:00
windows.md docs: Add documentation for installing via winget (#44941) 2025-12-16 09:13:48 +01:00
worktree-trust.md Remove global workspace trust concept (#45129) 2025-12-17 16:53:42 +00:00