1# Voice Transformation Examples
  2
  3Ten before/after transformations demonstrating Zed's brand voice. Use these as calibration for diagnosis and reconstruction.
  4
  5---
  6
  7## 1. Hype to Specifics
  8
  9**Before (Score: 2/5 Technical Grounding)**
 10
 11> Zed delivers blazingly fast performance that will revolutionize your coding experience. Our cutting-edge technology ensures you never wait again.
 12
 13**After (Score: 5/5)**
 14
 15> Zed is written in Rust with GPU-accelerated rendering. Keystrokes register in under 8ms. Scrolling stays at 120fps even in large files.
 16
 17**Transformation notes:**
 18
 19- "blazingly fast" → specific latency numbers
 20- "revolutionize" → removed entirely
 21- "cutting-edge technology" → actual tech stack
 22- "never wait again" → measurable claim
 23
 24---
 25
 26## 2. Marketing to Technical
 27
 28**Before (Score: 2/5 Developer Respect)**
 29
 30> Don't worry about the complicated stuff — Zed handles it all for you! Just focus on what you do best: writing amazing code.
 31
 32**After (Score: 5/5)**
 33
 34> Zed runs language servers in separate processes with automatic crash recovery. If a language server fails, you keep editing while it restarts.
 35
 36**Transformation notes:**
 37
 38- Removed patronizing tone ("don't worry")
 39- Removed enthusiasm ("amazing")
 40- Added technical mechanism
 41- Treats reader as capable of understanding
 42
 43---
 44
 45## 3. Abstract to Concrete
 46
 47**Before (Score: 2/5 Specificity)**
 48
 49> Zed provides a seamless collaborative experience that brings your team together in powerful new ways.
 50
 51**After (Score: 5/5)**
 52
 53> Share your workspace with `cmd+shift+c`. Collaborators see your cursor, selections, and edits in real time. Voice chat is built in — no separate call needed.
 54
 55**Transformation notes:**
 56
 57- "seamless" → actual UX flow
 58- "powerful new ways" → specific features
 59- Added keyboard shortcut (concrete entry point)
 60- Described what collaboration actually looks like
 61
 62---
 63
 64## 4. Em Dash Chains to Natural Flow
 65
 66**Before (Score: 2/5 Natural Syntax)**
 67
 68> Zed is fast — really fast — and built for the way developers actually work — not how tools think they should work.
 69
 70**After (Score: 5/5)**
 71
 72> Zed is built for speed. We optimized for the workflows developers actually use: jumping between files, searching across projects, editing multiple cursors at once.
 73
 74**Transformation notes:**
 75
 76- Removed all em dashes
 77- Split into two clear sentences
 78- Abstract claim → specific examples
 79- "really fast" → removed (show, don't tell)
 80
 81---
 82
 83## 5. Enthusiasm to Confidence
 84
 85**Before (Score: 1/5 Quiet Confidence)**
 86
 87> We're thrilled to announce Zed 1.0! After years of hard work, we can't wait for you to experience what we've built. You're going to love it!
 88
 89**After (Score: 5/5)**
 90
 91> Zed 1.0 is available today. This release includes GPU text rendering, multi-buffer editing, and native collaboration. Download it at zed.dev.
 92
 93**Transformation notes:**
 94
 95- Removed all emotional language
 96- "thrilled" → deleted
 97- "can't wait" → deleted
 98- "You're going to love it" → deleted
 99- Added substance instead of feelings
100
101---
102
103## 6. "It's Not X, It's Y" Fix
104
105**Before (Score: 2/5 Natural Syntax)**
106
107> Zed isn't just an editor — it's a complete development environment. It's not about features — it's about flow. And it's not slow — it's instant.
108
109**After (Score: 5/5)**
110
111> Zed combines editing, debugging, collaboration, and AI assistance in one application. Everything runs in the same process, so switching between tasks has no context-switch overhead.
112
113**Transformation notes:**
114
115- Eliminated all "it's not X, it's Y" patterns
116- Replaced negation with positive statements
117- Added technical reasoning
118- One clear sentence instead of three choppy ones
119
120---
121
122## 7. Vague Benefits to Specific Outcomes
123
124**Before (Score: 2/5 Specificity)**
125
126> Zed's AI integration enhances your productivity and streamlines your workflow, helping you code smarter and ship faster.
127
128**After (Score: 5/5)**
129
130> Zed runs AI completions inline as you type. Suggestions appear in 200ms. Accept with Tab, reject by continuing to type. The model runs locally or connects to your preferred API.
131
132**Transformation notes:**
133
134- "enhances productivity" → specific UX
135- "streamlines workflow" → actual interaction model
136- "code smarter" → deleted (meaningless)
137- Added technical options (local vs API)
138
139---
140
141## 8. Social Media Cleanup
142
143**Before (Score: 1/5 across multiple criteria)**
144
145> 🚀 Big news! Zed just dropped MASSIVE updates! Multi-file editing, insane AI features, and SO much more. This is a game-changer, folks! Try it now! 🔥
146
147**After (Score: 4/5)**
148
149> Zed 0.150: Multi-buffer editing is here. Edit across files in a single view. AI completions now stream inline. Full changelog at zed.dev/releases.
150
151**Transformation notes:**
152
153- Removed all emoji
154- Removed exclamation points
155- "MASSIVE" → specific features
156- "game-changer" → deleted
157- "SO much more" → link to changelog
158- Added version number for precision
159
160---
161
162## 9. Feature Announcement
163
164**Before (Score: 2/5 Information Priority)**
165
166> We've been listening to your feedback, and after months of development, our incredible team has built something truly special. Today, we're excited to finally share our new terminal integration!
167
168**After (Score: 5/5)**
169
170> Zed now includes a built-in terminal. Open it with `ctrl+\``. Terminals run in splits alongside your editor panes and share the same working directory as your project.
171
172**Transformation notes:**
173
174- Lead with the feature, not the backstory
175- Removed emotional buildup
176- Added keyboard shortcut
177- Described actual behavior
178
179---
180
181## 10. Philosophy Statement
182
183**Before (Score: 3/5 Quiet Confidence)**
184
185> At Zed, we believe that developers deserve better tools. We're passionate about creating the best possible coding experience because we know how frustrating slow, bloated editors can be.
186
187**After (Score: 5/5)**
188
189> Developer tools should be fast, understandable, and collaborative. We built Zed to meet that standard. It's open source so you can verify our work and extend it.
190
191**Transformation notes:**
192
193- "We believe" → direct statement
194- "passionate about" → deleted
195- "best possible" → specific standard
196- "frustrating, slow, bloated" → removed comparison
197- Added concrete proof point (open source)
198
199---
200
201## Fact Preservation Rules
202
203When transforming copy, certain elements must survive unchanged:
204
205### Mark During Diagnosis
206
207Tag factual claims with `[FACT]` during diagnosis phase:
208
209```
210Zed is written in [FACT: Rust] with [FACT: GPU-accelerated rendering].
211It was built by [FACT: the team behind Atom and Tree-sitter].
212```
213
214### Never Change
215
216| Category           | Examples                                   |
217| ------------------ | ------------------------------------------ |
218| Technical specs    | "120fps", "8ms latency", "Rust"            |
219| Proper nouns       | "Tree-sitter", "Anthropic", "Claude"       |
220| Version numbers    | "Zed 1.0", "v0.150"                        |
221| Keyboard shortcuts | "cmd+shift+c", "ctrl+\`"                   |
222| URLs               | "zed.dev/releases"                         |
223| Attribution        | "built by the team behind Atom"            |
224| Dates              | "available today", "released January 2024" |
225| Quotes             | Any attributed quotation                   |
226
227### Verification Step
228
229After reconstruction, diff against original `[FACT]` markers:
230
2311. List all facts from original
2322. Confirm each appears in final copy
2333. If a fact was removed, justify why (e.g., not relevant to new scope)
2344. If a fact was changed, flag as error
235
236### Example Verification
237
238**Original with markers:**
239
240> Zed is [FACT: written in Rust] with [FACT: GPU-accelerated rendering at 120fps]. Built by [FACT: the team behind Atom and Tree-sitter].
241
242**Reconstruction:**
243
244> Zed renders every frame on the GPU at 120fps. The Rust codebase prioritizes memory safety without garbage collection pauses. The same engineers who built Atom and Tree-sitter lead development.
245
246**Verification:**
247
248- ✅ "Rust" preserved
249- ✅ "GPU-accelerated" preserved
250- ✅ "120fps" preserved
251- ✅ "team behind Atom and Tree-sitter" preserved
252- **Pass**
253
254---
255
256## Transformation Patterns Summary
257
258| Problem              | Solution                     |
259| -------------------- | ---------------------------- |
260| Hype words           | Replace with measurements    |
261| Em dash chains       | Split into sentences         |
262| "It's not X, it's Y" | State positively what it is  |
263| Enthusiasm           | Delete; add substance        |
264| Vague benefits       | Name specific features       |
265| Buried lede          | Lead with the news           |
266| Rhetorical questions | Make declarative statements  |
267| Abstract claims      | Add mechanism or measurement |