Katie Geer
3daf6cdf6e
docs: Revise migration guides ( #49743 )
...
Release Notes:
- N/A *or* Added/Fixed/Improved ...
2026-02-20 11:57:46 -08:00
Katie Geer
809297a358
Fix broken accounts.html links in migrate docs ( #49744 )
...
Fixes broken `docs/accounts.html` links in all five migration guides.
## Changes
Replace `https://zed.dev/docs/accounts.html ` with
`https://zed.dev/docs/authentication ` in:
- `docs/src/migrate/vs-code.md`
- `docs/src/migrate/intellij.md`
- `docs/src/migrate/pycharm.md`
- `docs/src/migrate/webstorm.md`
- `docs/src/migrate/rustrover.md`
These links were flagged as 4xx in an SEO audit. The `accounts.html`
page does not exist; `authentication` is the correct destination.
Release Notes:
- N/A
2026-02-20 11:47:33 -08:00
morgankrey
9168df6260
docs: Apply documentation standards across all docs ( #49177 )
...
## Summary
Comprehensive remediation of 146 documentation files to align with Zed's
documentation conventions and brand voice guidelines.
## Changes
### YAML Frontmatter
- Added `title` and `description` frontmatter to all docs missing it
### Settings UI Pattern
- Updated 48+ files to show Settings Editor before JSON examples
- Pattern: `Configure X in Settings ({#kb zed::OpenSettings}), or add to
your settings file:`
- Added `([how to edit](./configuring-zed.md#settings-files))` links for
JSON-only settings
### Brand Voice Fixes
- Removed exclamation points (command-palette, key-bindings, repl,
privacy-and-security, etc.)
- Simplified em dash chains to parentheticals (environment,
troubleshooting, agent-panel, etc.)
- Fixed marketing language (yarn.md intro, development/linux.md)
### Terminology Alignment
- `settings UI` -> `Settings Editor`
- `sidebar` -> specific panel names (Project Panel, Collab Panel)
- `directory` -> `folder` in non-technical contexts
- `workspace` -> `project` in non-LSP contexts
- `Command Palette` -> `command palette` (lowercase)
### Callout Standardization
- Converted various callout formats to standard `> **Note:**` pattern
## Related
Depends on conventions established in #49176 .
Release Notes:
- N/A
2026-02-17 20:58:17 -06:00
Ben Brandt
7cea14362c
acp: Claude Code -> Claude Agent ( #49345 )
...
Update based on
https://platform.claude.com/docs/en/agent-sdk/overview#branding-guidelines
ACP package will be updated shortly.
Release Notes:
- acp: Claude Code is now referred to as Claude Agent, per Anthropic
branding guidelines.
2026-02-17 10:41:10 +00:00
1810ca0290
docs: Big reorganize ( #45276 )
...
Release Notes:
- N/A
Overview
Restructures the documentation navigation to be organized by user goals
rather than feature lists. Introduces a new "Working with Code" section
and reorganizes existing content into clearer groupings.
### Navigation Changes
**New top-level sections:**
- **Working with Code** — Groups editing, navigation, and execution
features by workflow
- **Reference** — Dedicated section for lookup-only content (settings,
actions, CLI)
- **Coming From...** — Migration guides grouped together
**Reorganized sections:**
- **Customization** — Renamed from "Configuration," focused on
appearance and keybindings
- **Account & Privacy** — Consolidated auth, privacy, and telemetry
pages
New Files
| File | Purpose |
|------|---------|
| `editing-code.md` | Overview page for editing features |
| `finding-navigating.md` | Overview page for navigation tools with
quick reference |
| `running-testing.md` | Overview page for tasks, debugger, and REPL |
| `reference/all-settings.md` | Settings reference (moved/renamed) |
| `reference/cli.md` | CLI reference (moved) |
### Content Moves
| Page | From | To |
|------|------|-----|
| Snippets | Customization | Working with Code → Editing Code |
| Code Completions | (flat) | Working with Code → Editing Code |
| Diagnostics | (flat) | Working with Code → Editing Code |
| Multibuffers | (flat) | Working with Code → Editing Code |
| Command Palette | (flat) | Working with Code → Finding & Navigating |
| Outline Panel | (flat) | Working with Code → Finding & Navigating |
| Tab Switcher | (flat) | Working with Code → Finding & Navigating |
| Tasks | (flat) | Working with Code → Running & Testing |
| Debugger | (flat) | Working with Code → Running & Testing |
| REPL | (flat) | Working with Code → Running & Testing |
| All Settings | Configuration | Reference |
| CLI | (various) | Reference
---------
Co-authored-by: Marshall Bowers <git@maxdeviant.com >
Co-authored-by: Zed Zippy <234243425+zed-zippy[bot]@users.noreply.github.com>
2026-01-20 13:04:27 -08:00
Rob Hand
6759a63105
docs: Update casing of Ty to ty ( #45622 )
...
### Why?
Small nit I noticed when configuring `ty` from Zed docs, ty should
always be stylized as lowercase.
See:
https://github.com/astral-sh/ty?tab=readme-ov-file#how-should-i-stylize-ty
Release Notes:
- N/A
2026-01-02 01:06:15 -05:00
Katie Geer
6145d9c524
docs: Add migrate docs for Webstorm / Pycharm / RustRover ( #45128 )
...
Release Notes:
- N/A
2025-12-17 08:44:48 -08:00
Katie Geer
a032fa02c2
docs: Migrate from Intellij ( #44928 )
...
Adding migration guide for Intellij as well as a doc of rules for agents
to help write future docs
Release Notes:
- N/A...
2025-12-16 10:47:24 -08:00
Katie Geer and Danilo Leal
1d2976dbf9
docs: Migrate from VS Code ( #43438 )
...
Add guide for users coming from VS Code
Release Notes:
- N/A
---------
Co-authored-by: Danilo Leal <daniloleal09@gmail.com >
2025-12-01 14:08:07 -08:00
Katie Geer