docs: Apply brand voice standards to AI documentation (#48401)
## Summary
Reviewed and updated all 18 files in `docs/src/ai/` to meet Zed's brand
voice standards. Each file was scored against the 8-criterion rubric and
rewritten where needed to achieve 4+ on all criteria.
**Changes include:**
- Remove "Learn how to/about" patterns (8 instances)
- Replace vague phrases ("various types of tasks", "and more") with
specific examples
- Remove taboo words ("seamless", "naturally extends")
- Remove emotional language ("We're excited/thrilled/happy")
- Remove marketing patterns ("Stay tuned!", exclamation points)
- Remove unverifiable claims ("world's fastest")
- Replace hedging with direct statements
- Remove promotional emphasis (`_free_`, `**_for free_**`)
- Fix typo in external-agents.md ("servers" → "serves")
- Fix broken link syntax for Ollama Turbo
## Test plan
- [x] `mdbook build` succeeds
- [x] Grep for remaining taboo phrases (only one "seamless" in MCP
official quote, preserved intentionally)
- [x] All facts preserved (URLs, keybindings, settings keys, prices,
model names)
Fixes AI-8
🤖 Generated with [Claude Code](https://claude.com/claude-code)
---------
Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
c9f65764a1
commit
7b95995e6f
26 files changed
+112
-188
No files matched your search
@@ -360,9 +360,9 @@ requirements.txt
|
||||
|
||||
These can be combined to tailor the experience for web servers, test runners, or custom scripts.
|
||||
|
||||
## Troubleshoot and Maintain a Productive Python Setup
|
||||
## Troubleshooting
|
||||
|
||||
Zed is designed to minimize configuration overhead, but occasional issues can still arise—especially around environments, language servers, or tooling. Here's how to keep your Python setup working smoothly.
|
||||
Issues with Python in Zed typically involve virtual environments, language servers, or tooling configuration.
|
||||
|
||||
### Resolve Language Server Startup Issues
|
||||
|
||||
|
||||
Reference in new issue
Block a user