Katie Geer created
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(-)
@@ -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)
@@ -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
@@ -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} |
@@ -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.