Translations
The list is maintained in several languages. English is canonical — when a translation and the English version disagree, English wins.
Available
| Language | File | Status |
|---|---|---|
| English | docs/index.md | Canonical |
| Türkçe | docs/languages/tr.md | Complete |
| 简体中文 | docs/languages/zh.md | Complete |
| Español | docs/languages/es.md | Complete |
Wanted
Highest-impact languages still missing, roughly by developer population:
- 日本語 (
docs/languages/ja.md) - Português - Brasil (
docs/languages/pt-BR.md) - Deutsch (
docs/languages/de.md) - Русский (
docs/languages/ru.md) - Français (
docs/languages/fr.md) - हिन्दी (
docs/languages/hi.md) - 한국어 (
docs/languages/ko.md) - Bahasa Indonesia (
docs/languages/id.md)
Claim one by opening an issue titled Translation: <language> so two people don’t duplicate the work.
How to add a language
- Copy
docs/index.mdtodocs/languages/<code>.md, using the BCP-47 code (ja,pt-BR,zh). - Translate the prose. Do not translate:
- Project names (
Ollama,LlamaIndex,pgvector) - Technical terms with no settled local equivalent (
embedding,quantization,prompt,token,RAG) — use the English term, optionally glossed once on first use - Code blocks, licenses, and URLs
- Project names (
- Keep the language bar at the top and mark your language as the active one (bold, not a link).
- Add a line to the “Available” table above.
- Add your language to the language bar in
docs/index.mdand every existing file indocs/languages/, so the pages stay cross-linked.
Structural rule
Every translation carries the same categories, same entries, in the same order as the English file. A translation is a translation, not a fork with local opinions. If you think an entry should be added or removed, open that PR against README.md first — once it lands there, it propagates to every language.
Staying in sync
Translations drift. That’s expected and acceptable — a slightly stale translation beats no translation.
- When you change
docs/index.md, you are not required to update every translation. Open an issue taggedtranslation-synclisting what changed, and translators pick it up. - To check whether a translation has drifted, compare its
###entry headings againstdocs/index.md— tool names are identical across languages by design, so diffing those lines shows exactly what’s missing. - Translations more than 6 months behind get a banner asking for a maintainer. They don’t get deleted.
Machine translation
Allowed as a starting point, not as a submission. A native or fluent speaker must read the whole file before the PR is opened — the “Edge” lines carry technical nuance that machine translation routinely flattens into marketing copy.