airflow-translations

Contributors

GitHub-linked commit authors for this SKILL.md at the saved revision. Co-authors and history before file renames are not included.

File history ↗

Add or update translations for the Apache Airflow UI. Guides through setting up locales, scaffolding translation files, translating with locale-specific guidelines, and validating results. Use when working with i18n tasks in airflow-core/src/airflow/ui/public/i18n/locales/.

.agents/skills/airflow-translations/SKILL.md

Download bundle ↓
main · 2aca1aa20 bundle filesScanned 2026-09-14

locales/pl.md

1,319 tokens · o200k_base · 4,820 bytes

Polish (pl)

This document provides locale-specific instructions for translating English Airflow UI strings into Polish. It inherits all global rules from the parent SKILL.md.

Plural Forms

Polish has four plural forms based on the count. Use the correct form for each suffix:

  • _one: 1 item (nominative singular)
  • _few: 2-4 items, 22-24, 32-34, etc. (nominative plural)
  • _many: 5+ items, 11-21, 25-31, etc. (genitive plural)
  • _other: fractions and general plural

English source:

"connection_one": "Connection",
"connection_few": "Connections",
"connection_many": "Connections",
"connection_other": "Connections"

Correct:

"connection_one": "Połączenie",
"connection_few": "Połączenia",
"connection_many": "Połączeń",
"connection_other": "Połączenia"

Incorrect:

"connection_few": "Połączeń",  // wrong case for 2-4
"connection_many": "Połączenia" // wrong case for 5+

Case Declension

Polish nouns change form by grammatical case. Use the appropriate case for context:

Nominative (subject):

"title": "Wszystkie połączenia"  // All connections

Genitive (possession, "of"):

"title": "Lista połączeń"  // List of connections

Accusative (direct object):

"button": "Dodaj połączenie"  // Add connection

Gender Agreement

Match noun gender (masculine/feminine/neuter) with verbs and adjectives:

Correct:

"message": "Połączenie zostało usunięte"  // neuter noun + neuter verb

Incorrect:

"message": "Połączenie został usunięty"  // neuter noun + masculine verb

Unchanged Terms

Keep these in English:

  • XCom — Airflow cross-communication term
  • ID — Technical identifier (always uppercase)
  • Dag / Dags → use Dag / Dagi (Polish plural adaptation)
  • Log levels: CRITICAL, ERROR, WARNING, INFO, DEBUG

Verb Forms and User Address

  • Use infinitive for commands: "Dodaj połączenie" (Add connection)
  • Use indicative for status: "Połączenie zostało usunięte" (Connection was deleted)
  • Use informal "ty" (lowercase) for questions: "Czy chcesz kontynuować?" (Do you want to continue?)

Correct:

"confirm": "Czy na pewno chcesz kontynuować?"

Incorrect:

"confirm": "Czy na pewno Pan chce kontynuować?"  // overly formal

Diacritics

Polish uses diacritics that must be preserved:

LetterCorrectIncorrect
ąbędąbedą
ćpołączeniepolaczenie
ęusunięteusuniete
łzostałzostal
ńkońkon
ógłównaglowna
święcejwiecej
źźródłozrodlo
żżadenzaden

Variable and Placeholder Examples

Preserve all {{variable}} placeholders. Adjust word order for natural Polish:

English source:

"title": "Delete {{count}} connections"

Correct:

"deleteConnection_one": "Usuń 1 połączenie",
"deleteConnection_few": "Usuń {{count}} połączenia",
"deleteConnection_many": "Usuń {{count}} połączeń"

Incorrect:

"title": "Usuń {{liczba}} połączeń"  // variable name translated

Terminology Glossary

Preferred wording for specific UI terms. Apply these to new translations and prefer them when reviewing existing ones.

English / contextPreferred PolishAvoid
Consuming Asset (asset consumed by a Dag run)Zabierający zasóbKonsumujący zasób
Bulk clear / delete / update (toaster and button labels)grupowy / grupowego / grupowej / grupowe …masowy / masowego / masowej / masowe
Deactivated (Dag header status)Deaktywowany / Deaktywowana / DeaktywowaneDezaktywowany

Notes:

  • For "bulk " always use "grupowy" with the grammatical form that matches the noun — e.g. "żądanie grupowego wyczyszczenia", "żądanie grupowej aktualizacji". Never use "masowy".
  • "Deactivated" / "Deaktywowany" must agree in gender with the noun it describes (e.g. neuter "zadanie" → "Deaktywowane").

Terminology Reference

The established Polish translations are defined in the existing locale files. Before translating, read the existing pl JSON files to learn the established terminology:

airflow-core/src/airflow/ui/public/i18n/locales/pl/

Use the translations found in these files as the authoritative glossary. When translating a term, check how it has been translated elsewhere in the locale to maintain consistency. If a term has not been translated yet, refer to the English source in en/ and apply the rules in this document.

Referenced from SKILL.md