🇺🇦 ua-tech-glossary

Open English→Ukrainian IT terminology glossary
Відкритий англо-український глосарій IT-термінів

Українська · Usage · Add term · Found an error? · Vote

---

2995 terms · 11 categories · YAML format · Living translations

Primary translation — how Ukrainian IT professionals actually speak (баг, деплой, коміт, фіча). Alternatives — formal standard variants (помилка, розгортання, фіксація, функціонал).

---

📖 How to use

For people — just browse

📋 Readable tables — open any file in glossary/md/ to browse terms as a table:

EN	UK	Alternatives	Status
firewall	файрвол	міжмережевий екран, брандмауер	✅
deploy	деплой	розгортання	🔍

Categories: general · dev · security · networking · hardware · databases · ui-ux · cloud · ai-ml · devops-ci · git-vcs

🔍 Local search — find any term by EN or UK:

python scripts/search.py firewall
#  ✅ [security    ] firewall                 → файрвол  alt: міжмережевий екран, брандмауер

python scripts/search.py деплой
#  🔍 [devops-ci   ] deployment               → деплой  alt: розгортання

python scripts/search.py --category dev pattern
#  (search only within dev category)

🔄 Regenerate MD after changes — if you edit any YAML file, regenerate the tables:

python scripts/generate_md.py

📦 Raw YAML — for integration, use the source files in glossary/:

- en: firewall
  uk: файрвол
  uk_alt: [міжмережевий екран, брандмауер]
  status: approved
  category: security

For developers — integrate into your project

# As a git submodule
git submodule add https://github.com/edocltd/ua-tech-glossary.git glossary

# Or just download a specific file
curl -O https://raw.githubusercontent.com/edocltd/ua-tech-glossary/main/glossary/dev.yaml

Python parsing:

import yaml

with open('glossary/dev.yaml') as f:
    terms = yaml.safe_load(f)

lookup = {t['en']: t['uk'] for t in terms}
print(lookup['deploy'])  # деплой

JavaScript parsing:

import { readFileSync } from 'fs';
import { parse } from 'yaml';

const terms = parse(readFileSync('glossary/dev.yaml', 'utf8'));
const lookup = Object.fromEntries(terms.map(t => [t.en, t.uk]));
console.log(lookup['deploy']); // деплой

Integration with other tools

Tool	How to integrate
Software localization	Import YAML → generate .po, .json, .xliff
IDE plugins	Autocomplete translations from YAML files
CI/CD	Validate translations in PRs via scripts/validate.py
Web app	Serve YAML → JSON as a static REST API

---

➕ Add a term

Can't find a term? Add it in 2 minutes!

Option 1: Via Issue (easiest)

1. Open New Issue
2. Fill in: EN term, your translation, category
3. The community will review and add it

Option 2: Via Pull Request

1. Fork the repository
2. Add an entry to the appropriate glossary/{category}.yaml:

   - en: your term
     uk: your translation
     status: review
     category: dev

3. Create a PR explaining your translation choice

Rules:

• en — lowercase (except abbreviations: API, HTTP)
• uk — living translation first, formal in uk_alt
• status: review for new entries
• One term = one entry (no duplicates)

---

🐛 Report a mistake

Found an inaccurate translation? That's normal — the glossary is alive!

1. Open New Issue
2. Specify: EN term, current UK translation, correct variant
3. Or submit a PR with the fix directly

Common issues:

• ❌ Translation doesn't match the EN term (PDF parsing shift)
• ❌ Formal translation instead of living (or vice versa)
• ❌ Truncated translation
• ❌ Irrelevant Multitran alternative

---

🗳 Vote on translations

Disagree with a translation? Propose your variant!

How voting works

1. Find or create an Issue with label term-review
2. Propose your translation in a comment
3. Vote 👍/👎 on other variants
4. The variant with most support becomes uk, others → uk_alt

When to vote?

• When multiple variants are equally valid (e.g., "репозиторій" vs "сховище" vs "репо")
• When a living variant conflicts with the formal one
• When a new term has no established translation yet

Statuses:

Status	Meaning
review	New, needs community verification
approved	Verified (Multitran or by vote)
deprecated	Obsolete, replaced by another

---

📁 Project structure

ua-tech-glossary/
├── glossary/
│   ├── _schema.yaml          # Entry schema
│   ├── general.yaml           # General terms (2102)
│   ├── git-vcs.yaml           # Git & VCS terms (15)
│   ├── dev.yaml               # Development, languages, patterns (316)
│   ├── security.yaml          # Cybersecurity, cryptography (149)
│   ├── hardware.yaml          # Hardware, memory, peripherals (107)
│   ├── networking.yaml        # Networks, protocols (94)
│   ├── ui-ux.yaml             # Interface, design (95)
│   ├── databases.yaml         # Databases, SQL (64)
│   ├── cloud.yaml             # Cloud, virtualization (22)
│   ├── ai-ml.yaml             # AI, machine learning (18)
│   ├── devops-ci.yaml         # DevOps, CI/CD (13)
│   └── md/                    # 📋 Browsable MD tables (auto-generated)
├── docs/
│   └── sources.md             # Sources registry
├── scripts/
│   ├── search.py              # 🔍 Search terms by EN/UK
│   ├── generate_md.py         # 🔄 Generate MD tables from YAML
│   ├── verify_multitran.py    # Multitran verification
│   └── scrape_multitran.py    # Multitran scraper (run locally)
├── .github/
│   └── ISSUE_TEMPLATE/
│       ├── new-term.md
│       └── fix-translation.md
├── README.md                  # This file (English)
├── README.uk.md               # Ukrainian version
├── CONTRIBUTING.md            # How to contribute (English)
├── CONTRIBUTING.uk.md         # Як долучитися (Українська)
└── LICENSE

---

📊 Statistics

Category	Entries	Approved
general	2102	943
dev	316	48
security	149	39
hardware	107	44
ui-ux	95	21
networking	94	25
databases	64	23
cloud	22	—
ai-ml	18	—
git-vcs	15	15
devops-ci	13	—
Total	2995	1158

---

🏗 Sources

Full registry: docs/sources.md

Primary: Microsoft Glossary (SNTT/Lviv Polytechnic), 2 cybersecurity dictionaries, naurok.com.ua, Lenovo Glossary, Wikipedia CS/Graphics/Video glossaries, awesome-developer-dictionary, Wiktionary.

Verification: Multitran EN→UK IT category (40k+ entries).

---

📜 License

MIT — free to use, modify, and distribute.

---

🤝 How to contribute

Details: CONTRIBUTING.md | Українською

In short:

1. 🐛 Found an error → Issue
2. ➕ Add a term → Issue or PR
3. 🗳 Vote → Issues: term-review
4. 💻 Code/scripts → PR with description

---

_{Built for the Ukrainian IT community 🇺🇦}