From ec4acde841f7a554efb27d379163b157fb05df48 Mon Sep 17 00:00:00 2001 From: Katie Geer Date: Thu, 18 Dec 2025 11:30:15 -0800 Subject: [PATCH] Add new editing, finding, and code pages --- docs/src/SUMMARY.md | 2 +- docs/src/editing-code.md | 30 ++++++++++++++++++++ docs/src/finding-navigating.md | 52 ++++++++++++++++++++++++++++++++++ docs/src/running-testing.md | 19 +++++++++++++ 4 files changed, 102 insertions(+), 1 deletion(-) create mode 100644 docs/src/editing-code.md create mode 100644 docs/src/finding-navigating.md create mode 100644 docs/src/running-testing.md diff --git a/docs/src/SUMMARY.md b/docs/src/SUMMARY.md index a4a0d420c1d7a9ccc042d1e063f3faf9fee568ef..b6b5af023de46ba4efd727252c53f36800fffc5e 100644 --- a/docs/src/SUMMARY.md +++ b/docs/src/SUMMARY.md @@ -178,7 +178,7 @@ # Account & Privacy -- [Sign In](./authentication.md) +- [Authenticate](./authentication.md) - [Privacy and Security](./ai/privacy-and-security.md) - [Worktree Trust](./worktree-trust.md) - [AI Improvement](./ai/ai-improvement.md) diff --git a/docs/src/editing-code.md b/docs/src/editing-code.md new file mode 100644 index 0000000000000000000000000000000000000000..a77be045a6f6d6bbe513133ead4c75a3c29c1c01 --- /dev/null +++ b/docs/src/editing-code.md @@ -0,0 +1,30 @@ +# Editing Code + +Zed provides tools to help you write and modify code efficiently. This section covers the core editing features that work alongside your language server. + +## What's in This Section + +- **[Code Completions](./completions.md)** — Autocomplete from language servers and AI-powered edit predictions +- **[Diagnostics & Quick Fixes](./diagnostics.md)** — View errors, warnings, and apply fixes from your language server +- **[Multibuffers](./multibuffers.md)** — Edit multiple files simultaneously with multiple cursors + +## How These Features Work Together + +When you're editing code, Zed combines input from multiple sources: + +1. **Language servers** provide completions, diagnostics, and quick fixes based on your project's types and structure +2. **Edit predictions** suggest multi-character or multi-line changes as you type +3. **Multibuffers** let you apply changes across files in one operation + +For example, you might: + +- Rename a function using your language server's rename refactor +- See the results in a multibuffer showing all affected files +- Use multiple cursors to make additional edits across all locations +- Get immediate diagnostic feedback if something breaks + +## Related Features + +- [Configuring Languages](./configuring-languages.md) — Set up language servers for your project +- [Snippets](./snippets.md) — Insert reusable code templates +- [Key Bindings](./key-bindings.md) — Customize keyboard shortcuts for editing commands diff --git a/docs/src/finding-navigating.md b/docs/src/finding-navigating.md new file mode 100644 index 0000000000000000000000000000000000000000..23f880eb4fbe8773211e56efd78dc600976cc488 --- /dev/null +++ b/docs/src/finding-navigating.md @@ -0,0 +1,52 @@ +# Finding & Navigating + +Zed provides several ways to move around your codebase quickly. Here's an overview of the main navigation tools. + +## Command Palette + +The Command Palette ({#kb command_palette::Toggle}) is your gateway to almost everything in Zed. Type a few characters to filter commands, then press Enter to execute. + +[Learn more about the Command Palette →](./command-palette.md) + +## File Finder + +Open any file in your project with {#kb file_finder::Toggle}. Type part of the filename or path to narrow results. + +## Project Search + +Search across all files with {#kb pane::DeploySearch}. Results appear in a [multibuffer](./multibuffers.md), letting you edit matches in place. + +## Go to Definition + +Jump to where a symbol is defined with {#kb editor::GoToDefinition} (or `Cmd+Click` / `Ctrl+Click`). If there are multiple definitions, they open in a multibuffer. + +## Go to Symbol + +- **Current file:** {#kb outline::Toggle} opens an outline of symbols in the active file +- **Entire project:** {#kb project_symbols::Toggle} searches symbols across all files + +## Outline Panel + +The Outline Panel ({#kb outline_panel::ToggleFocus}) shows a persistent tree view of symbols in the current file. It's especially useful with [multibuffers](./multibuffers.md) for navigating search results or diagnostics. + +[Learn more about the Outline Panel →](./outline-panel.md) + +## Tab Switcher + +Quickly switch between open tabs with {#kb tab_switcher::Toggle}. Tabs are sorted by recent use—keep holding Ctrl and press Tab to cycle through them. + +[Learn more about the Tab Switcher →](./tab-switcher.md) + +## Quick Reference + +| Task | Keybinding | +|------|------------| +| Command Palette | {#kb command_palette::Toggle} | +| Open file | {#kb file_finder::Toggle} | +| Project search | {#kb pane::DeploySearch} | +| Go to definition | {#kb editor::GoToDefinition} | +| Find references | {#kb editor::FindAllReferences} | +| Symbol in file | {#kb outline::Toggle} | +| Symbol in project | {#kb project_symbols::Toggle} | +| Outline Panel | {#kb outline_panel::ToggleFocus} | +| Tab Switcher | {#kb tab_switcher::Toggle} | diff --git a/docs/src/running-testing.md b/docs/src/running-testing.md new file mode 100644 index 0000000000000000000000000000000000000000..3c23b9b2f3144687047f882b481d71411966eaff --- /dev/null +++ b/docs/src/running-testing.md @@ -0,0 +1,19 @@ +# Running & Testing + +This section covers how to run, test, and debug your code without leaving Zed. + +## What's here + +- **[Tasks](./tasks.md)**: Define and run shell commands with access to editor context like the current file, selection, or symbol. Use tasks to build, lint, run scripts, or execute any repeatable workflow. + +- **[Debugger](./debugger.md)**: Set breakpoints, step through code, and inspect variables using Zed's built-in debugger. Works with C, C++, Go, JavaScript, Python, Rust, TypeScript, and more through the Debug Adapter Protocol. + +- **[REPL](./repl.md)**: Run code interactively using Jupyter kernels. Execute selections or cells and see results inline—useful for Python, TypeScript (Deno), R, Julia, and other supported languages. + +## Quick start + +**Run a command**: Press `Cmd+Shift+T` (macOS) or `Ctrl+Shift+T` (Linux/Windows) to open the task picker, then type any shell command. + +**Start debugging**: Press `Cmd+Shift+D` (macOS) or `Ctrl+Shift+D` (Linux/Windows) to open the debug panel and select a configuration. + +**Run code interactively**: In a Python or TypeScript file, select some code and press `Ctrl+Shift+Enter` to execute it in a REPL session.