morgankrey
933273061e
## Summary
- Adds a new concept page (`docs/src/windows-and-projects.md`)
explaining how Zed handles multiple projects in windows
- Fixes the VS Code migration guide which incorrectly stated "Zed does
not support multi-root workspaces"
- Adds cross-links from Getting Started, CLI Reference, and Parallel
Agents docs
## Context
With multi-workspace now universally enabled, the default behavior is:
- **File > Open** opens projects in the current window's sidebar (not a
new window)
- **Cmd+Enter** in Open Recent opens in a new window
- **CLI `-n` flag** forces a new window
The VS Code migration guide was telling users the opposite of reality.
This PR fixes that and provides a central concept page that other docs
can link to.
## Changes
| File | Change |
|------|--------|
| `windows-and-projects.md` | New concept page |
| `SUMMARY.md` | Add to Working with Code section |
| `getting-started.md` | Note about sidebar default + link |
| `migrate/vs-code.md` | Fix "no multi-root" claim → explain sidebar
model |
| `reference/cli.md` | Link to concept page from flags section |
| `ai/parallel-agents.md` | Cross-reference in Multiple Projects section
|
## Test plan
- [ ] Verify page renders correctly on docs site
- [ ] Check all internal links resolve
- [ ] Confirm `{#kb projects::OpenRecent}` renders the correct
keybinding
Release Notes:
- N/A
6.5 KiB
6.5 KiB
Summary
Welcome
AI
- Overview
- Agent Panel
- Parallel Agents
- Inline Assistant
- Edit Prediction
- Rules
- Model Context Protocol
- Configuration
- Models
- Providers
Working with Code
Collaboration
Remote Development
Account & Billing
Zed Business
Privacy & Security
Platform Support
Customization
Language Support
- All Languages
- Configuring Languages
- Ansible
- AsciiDoc
- Astro
- Bash
- Biome
- C
- C++
- C#
- Clojure
- CSS
- Dart
- Deno
- Diff
- Docker
- Elixir
- Elm
- Emmet
- Erlang
- Fish
- GDScript
- Gleam
- GLSL
- Go
- Groovy
- Haskell
- Helm
- HTML
- Java
- JavaScript
- Julia
- JSON
- Jsonnet
- Kotlin
- Lua
- Luau
- Makefile
- Markdown
- Nim
- OCaml
- OpenTofu
- PHP
- PowerShell
- Prisma
- Proto
- PureScript
- Python
- R
- Rego
- ReStructuredText
- Racket
- Roc
- Ruby
- Rust
- Scala
- Scheme
- Shell Script
- SQL
- Standard ML
- Svelte
- Swift
- Tailwind CSS
- Terraform
- TOML
- TypeScript
- Uiua
- Vue
- XML
- YAML
- Yara
- Yarn
- Zig
Extensions
- Overview
- Installing Extensions
- Developing Extensions
- Extension Capabilities
- Language Extensions
- Debugger Extensions
- Theme Extensions
- Icon Theme Extensions
- Snippets Extensions
- Agent Server Extensions
- MCP Server Extensions