Keep the tool word, translate the concept
Words the learner will type or see on screen stay as they are: git, prompt, agent, API, deploy, token, repo, frontend, backend, MCP, Claude Code. Words that have already settled into Kazakh are written in Cyrillic: агент, токен, модель, сервер, код, файл, промпт, репозиторий, коммит. Everything else gets a real Kazakh word: қолданба (app), тармақ (branch), біріктіру (merge), дерекқор (database), сілтеме (link), құпиясөз (password).
Latin word + hyphen + Kazakh ending
Attach the ending with a hyphen, never an apostrophe and never a space: GitHub-қа, git-те, Claude Code-ты, API-ге, LLM-ді, Vercel-ге. Choose the ending by how the word sounds, not how it is spelled: Claude is read [клод], so it behaves like a back-vowel word ending in a hard consonant, giving Claude-қа and Claude-та. When the reading is unclear (Gemini, production, CLI, IDE, README), drop the suffix and put a Kazakh descriptor noun after the name instead: CLI құралында, production ортасына, README файлын.
Cyrillic loans take endings directly
A word already written in Cyrillic needs no hyphen: промптты, токендер, серверге, репозиторийде, агентпен, модельдің. The hyphen belongs to Latin script and to acronyms only. Kazakh also never uses an apostrophe for this, so API-ге is right and API`ге is not.
Never suffix a command or a file name
A command has to be typed character for character, so it never carries a Kazakh ending. Wrap it in a descriptor noun instead: write «npm install пәрменін орында», not «npm install-ды орында»; write «CLAUDE.md файлын аш», not «CLAUDE.md-ны аш». The same holds for file names, flags and anything shown as inline code.
Address the learner as сен
Learner-facing prose, tips and quiz feedback use сен: «Промптты нақтырақ жаз», «Жарайсың!». Buttons and menu items use the neutral infinitive, so the interface itself never has to choose a register: «Бастау», «Сақтау», «Кодты көшіру». Error messages use no second person at all and no exclamation mark: «Жүктеу мүмкін болмады», not «Сен жүктей алмадың». Prompts written to an AI are сен-form imperatives too, which is exactly the register the learner will be typing all day.
Numbers and dates the Kazakh way
Dates start with the year: «2026 ж. 22 қыркүйек»; the short form is 22.09.2026. Months and weekdays are lowercase. Time is 24-hour (19:00) and a range uses an en dash with no spaces (19:00–21:00). Decimals take a comma (3,5), thousands a non-breaking space (1 500), money the same (5 000 ₸). Percent has no space, 80%, and its ending takes a hyphen, «80%-ы». A noun after a numeral stays singular: «5 сабақ», «3 коммит», never «5 сабақтар». Ordinals written in digits take a hyphen: «1-қадам», «3-модуль». A version is written «2.3 нұсқасы».
Drop the Russian calques
Use қолданба not қосымша, жүктеп алу not скачать ету, параметрлер not настройкалар, құпиясөз not пароль, сілтеме not ссылка, түйме not кнопка, қалта not папка, пайдаланушы not юзер, әзірлеуші not разработчик, нұсқа not версия, әдепкі not по умолчанию, дерекқор not мәліметтер базасы. Never hang Russian verb endings on an English root: instead of закоммитить, запушить, пофиксить, задеплоить write «commit жасау», «push жасау», «түзету», «deploy жасау». And never use the Russian-flavoured spellings бэкенд, фронтэнд, деплой, вайб-кодинг: backend, frontend, deploy and vibe coding stay in Latin.
Gloss the term once, then use the short form
The first time a term appears on a page, give the Kazakh rendering with the English in parentheses: «Тармақ (branch) — кодтың жеке көшірмесі…». After that use whichever form is shorter and clearer, тармақ or branch. This rule applies per page, not per site, because most people arrive straight into one lesson from search.