# docs: Big reorganize \(\#45276\) · gitcafe/zed

[View on GitCafe](https://git.cafe/gitcafe/zed/commit/ece66be3df5958e538e1e781e6ba3750e8e1bd14)

Repository: [gitcafe/zed](https://git.cafe/gitcafe/zed)

Visibility: public

Requested revision: ece66be3df5958e538e1e781e6ba3750e8e1bd14

Requested commit: ece66be3df5958e538e1e781e6ba3750e8e1bd14

Commit: ece66be3df5958e538e1e781e6ba3750e8e1bd14

Tree: a704ea243b2cbd756b3c31a14e7123be99b47887

Author: Katie Geer

Committer: GitHub

## Message

```
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>
```

## Parents

- [9c3dc216c6e0b80a2e895869adbf7e184321ddae](https://git.cafe/gitcafe/zed/commit/9c3dc216c6e0b80a2e895869adbf7e184321ddae?format=markdown)

[Source at this commit](https://git.cafe/gitcafe/zed/tree/ece66be3df5958e538e1e781e6ba3750e8e1bd14?format=markdown)