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:
morgankreyandClaude Opus 4.5 authored and GitHub committed 2026-02-04 14:11:55 -08:00
1 parent c9f65764a1
commit 7b95995e6f
26 files changed
+112 -188

No files matched your search

+2 -2
View File
@@ -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