vrr/zed
2
0
Fork 0
mirror of https://github.com/zed-industries/zed.git synced 2026-05-25 23:04:27 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 16
zed/docs/src/languages
History
morgankrey 4433d6d855
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>
2026-02-04 14:11:55 -08:00
..
ansible.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
asciidoc.md docs: Fix casing of "Tree-sitter" (#25427) 2025-02-23 15:30:10 +00:00
astro.md docs: Point to the right URL for Astro LSP (#44314) 2025-12-06 19:14:13 -05:00
bash.md docs: Fix casing of "Tree-sitter" (#25427) 2025-02-23 15:30:10 +00:00
biome.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
c.md languages: Recognize .clangd as YAML (#43557) 2025-11-26 15:55:23 +01:00
clojure.md docs: Fix casing of "Tree-sitter" (#25427) 2025-02-23 15:30:10 +00:00
cpp.md docs: Document implemented clangd extensions (#44308) 2025-12-15 02:16:48 -05:00
csharp.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
css.md docs: Fix link/reference in CSS language doc (#39952) 2025-10-11 07:38:13 +00:00
dart.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
deno.md Replace deprecated json.schemastore.org with www.schemastore.org (#42336) 2025-11-11 15:43:25 +02:00
diff.md docs: Big reorganize (#45276) 2026-01-20 13:04:27 -08:00
docker.md docs: Fix minor typo in docker.md (#43334) 2025-11-22 22:11:41 +02:00
elixir.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
elm.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
emmet.md emmet: Extract to zed-extensions/emmet repository (#36323) 2025-08-16 17:02:51 +00:00
erlang.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
fish.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
gdscript.md Update GDScript documentation (#41142) 2025-10-25 15:59:04 +03:00
gleam.md docs: Fix casing of "Tree-sitter" (#25427) 2025-02-23 15:30:10 +00:00
glsl.md docs: Fix casing of "Tree-sitter" (#25427) 2025-02-23 15:30:10 +00:00
go.md docs: Improve debug adapter documentation (#40441) 2025-10-17 00:36:47 +00:00
groovy.md docs: Fix casing of "Tree-sitter" (#25427) 2025-02-23 15:30:10 +00:00
haskell.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
helm.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
html.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
java.md Update documentation on Java support (#41758) 2025-11-05 12:24:29 +01:00
javascript.md docs: Big reorganize (#45276) 2026-01-20 13:04:27 -08:00
json.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
jsonnet.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
julia.md docs: Fix casing of "Tree-sitter" (#25427) 2025-02-23 15:30:10 +00:00
kotlin.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
lua.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
luau.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
makefile.md docs: Fix casing of "Tree-sitter" (#25427) 2025-02-23 15:30:10 +00:00
markdown.md docs: Big reorganize (#45276) 2026-01-20 13:04:27 -08:00
nim.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
ocaml.md typo: Use tips from proselint (#42362) 2025-11-10 17:51:44 +02:00
opentofu.md docs: Add documenation for OpenTofu support (#42448) 2025-11-18 18:40:09 -05:00
php.md Update PHP language server docs (#44001) 2025-12-04 19:04:06 +01:00
powershell.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
prisma.md docs: Fix casing of "Tree-sitter" (#25427) 2025-02-23 15:30:10 +00:00
proto.md docs: Big reorganize (#45276) 2026-01-20 13:04:27 -08:00
purescript.md purescript: Extract to zed-extensions/purescript repository (#26571) 2025-03-12 18:42:12 +00:00
python.md docs: Apply brand voice standards to AI documentation (#48401) 2026-02-04 14:11:55 -08:00
r.md Revise R documentation - about Air in particular (#42755) 2025-11-17 11:53:42 -07:00
racket.md docs: Fix casing of "Tree-sitter" (#25427) 2025-02-23 15:30:10 +00:00
rego.md docs: Point to the right URL for Regal LSP (#44318) 2025-12-07 05:29:58 +00:00
roc.md docs: Fix casing of "Tree-sitter" (#25427) 2025-02-23 15:30:10 +00:00
rst.md docs: Fix casing of "Tree-sitter" (#25427) 2025-02-23 15:30:10 +00:00
ruby.md docs: Add Tailwind configuration section for JavaScript/TypeScript (#45057) 2025-12-17 14:16:37 +00:00
rust.md docs: Improve debug adapter documentation (#40441) 2025-10-17 00:36:47 +00:00
scala.md docs: Fix casing of "Tree-sitter" (#25427) 2025-02-23 15:30:10 +00:00
scheme.md docs: Fix casing of "Tree-sitter" (#25427) 2025-02-23 15:30:10 +00:00
sh.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
sql.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
svelte.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
swift.md docs: Improve debug adapter documentation (#40441) 2025-10-17 00:36:47 +00:00
tailwindcss.md docs: Remove preview indicator for Tailwind CSS Mode (#47651) 2026-01-26 15:12:49 +01:00
terraform.md docs: Validate JSON snippets (settings, keymap, tasks, etc) (#40043) 2025-10-12 00:19:57 -04:00
toml.md docs: Update TOML docs (#37561) 2025-09-04 18:54:32 +00:00
typescript.md docs: Add Tailwind configuration section for JavaScript/TypeScript (#45057) 2025-12-17 14:16:37 +00:00
uiua.md uiua: Extract to zed-extensions/uiua repository (#26587) 2025-03-12 19:55:37 +00:00
vue.md docs: Fix casing of "Tree-sitter" (#25427) 2025-02-23 15:30:10 +00:00
xml.md docs: Big reorganize (#45276) 2026-01-20 13:04:27 -08:00
yaml.md Replace deprecated json.schemastore.org with www.schemastore.org (#42336) 2025-11-11 15:43:25 +02:00
yara.md markup: Update yara.md (#39027) 2025-09-27 19:43:19 +02:00
yarn.md docs: Big reorganize (#45276) 2026-01-20 13:04:27 -08:00
zig.md zig: Extract to zed-extensions/zig repository (#26569) 2025-03-12 18:28:26 +00:00