Құрал атауын сақта, ұғымды аудар
Үйренуші теретін немесе экраннан көретін сөздер сол күйінде қалады: git, prompt, agent, API, deploy, token, repo, frontend, backend, MCP, Claude Code. Қазақ тілінде әбден орныққан сөздер кириллицамен жазылады: агент, токен, модель, сервер, код, файл, промпт, репозиторий, коммит. Қалғанының бәріне нақты қазақ сөзі алынады: қолданба (app), тармақ (branch), біріктіру (merge), дерекқор (database), сілтеме (link), құпиясөз (password).
Латын сөзі + дефис + қазақша жалғау
Жалғау дефис арқылы жалғанады: апостроф та, бос орын да қойылмайды — GitHub-қа, git-те, Claude Code-ты, API-ге, LLM-ді, Vercel-ге. Жалғаудың түрі жазылуына емес, айтылуына қарай таңдалады: Claude [клод] деп оқылады, сондықтан жуан әрі қатаң түрі жалғанады — Claude-қа, Claude-та. Оқылуы күмәнді болса (Gemini, production, CLI, IDE, README), жалғауды мүлде қоспай, артынан қазақша анықтауыш сөз қой: CLI құралында, production ортасына, README файлын.
Кириллицамен жазылған сөзге жалғау тікелей жалғанады
Кириллицамен жазылып тұрған сөзге дефис қойылмайды: промптты, токендер, серверге, репозиторийде, агентпен, модельдің. Дефис — тек латын әрпімен жазылған сөз бен қысқарған сөзге арналған. Қазақ тілінде бұл жерде апостроф та қолданылмайды: API-ге деп жазылады.
Пәрмен мен файл атауына жалғау жалғанбайды
Пәрмен әріпме-әріп теріледі, сондықтан оған қазақша жалғау жалғанбайды. Оның орнына артынан анықтауыш сөз қой: «npm install пәрменін орында» деп жаз, «npm install-ды орында» деп жазба; «CLAUDE.md файлын аш» деп жаз, «CLAUDE.md-ны аш» деп жазба. Бұл ереже файл атауына, жалаушаларға және код түрінде көрсетілген кез келген үзіндіге қатысты.
Үйренушіге «сен» деп сөйле
Үйренушіге арналған мәтін, кеңес және тест жауабы «сен» түрінде жазылады: «Промптты нақтырақ жаз», «Жарайсың!». Түйме мен мәзір атаулары бейтарап тұйық етістікпен беріледі, сонда интерфейстің өзі ешқандай мәнер таңдамайды: «Бастау», «Сақтау», «Кодты көшіру». Қате хабарларында екінші жақ та, леп белгісі де болмайды: «Жүктеу мүмкін болмады» — «Сен жүктей алмадың» емес. ЖИ-ге жазылатын промпт та «сен» түріндегі бұйрық райда, өйткені үйренуші күні бойы дәл сол мәнерде жазады.
Сан мен күнді қазақша жаз
Күн жылдан басталады: «2026 ж. 22 қыркүйек»; қысқа түрі — 22.09.2026. Ай мен апта күндері кіші әріппен жазылады. Уақыт 24 сағаттық (19:00), аралығы бос орынсыз сызықшамен беріледі (19:00–21:00). Ондық бөлшекте үтір (3,5), мыңдықтар ажыратылмайтын бос орынмен бөлінеді (1 500), ақша да солай (5 000 ₸). Пайыз бос орынсыз жазылады — 80%, жалғауы дефиспен — «80%-ы». Сан алдында тұрса, зат есім көпше тұлғада болмайды: «5 сабақ», «3 коммит», ешқашан «5 сабақтар» емес. Цифрмен жазылған реттік санға дефис қойылады: «1-қадам», «3-модуль». Нұсқа «2.3 нұсқасы» деп жазылады.
Орыс тілінен көшірілген сөздерді қолданба
«Қосымша» емес — қолданба, «скачать ету» емес — жүктеп алу, «настройкалар» емес — параметрлер, «пароль» емес — құпиясөз, «ссылка» емес — сілтеме, «кнопка» емес — түйме, «папка» емес — қалта, «юзер» емес — пайдаланушы, «разработчик» емес — әзірлеуші, «версия» емес — нұсқа, «мәліметтер базасы» емес — дерекқор. Ағылшын түбіріне орысша етістік жалғауын жапсырма: «закоммитить», «запушить», «пофиксить», «задеплоить» дегеннің орнына «commit жасау», «push жасау», «түзету», «deploy жасау» деп жаз. «Бэкенд», «фронтэнд», «деплой», «вайб-кодинг» деп те жазылмайды: backend, frontend, deploy, vibe coding латынша қалады.
Терминді бір рет түсіндір, сосын қысқа түрін қолдан
Термин бетте бірінші рет кездескенде қазақша түрін беріп, жақша ішінде ағылшыншасын жаз: «Тармақ (branch) — кодтың жеке көшірмесі…». Одан әрі қайсысы қысқа әрі түсінікті, соны қолдана бер: «тармақ» немесе «branch». Бұл ереже әр бетке бөлек қолданылады, өйткені адам іздеуден бірден бір сабаққа түсуі мүмкін.