Hi Jens, Great point! I agree that each locale should track the reasons for its terminology choices. I will cross-post this to the German sub-issue and mention this convention in the meta issue. Thanks!
Best, Jason On Tue, Feb 17, 2026 at 5:34 AM Jens Scheffler <[email protected]> wrote: > Hi! > > Good initiative to make it common. Please consider that for the German > we created a > airflow-core/src/airflow/ui/public/i18n/locales/de/README.md that > describes _WHY_ we have selected which specific terms in the local > translation. So encouraging that other translations maybe follow same > approach. If need to be re-formatted for agent based processing this > would be finde but I'd otherwise request to consider the existing > definitions. > > Not sure if it is beneficial if it is renamed "de.md" instead of > README.md though. > > Jens > > On 16.02.26 15:57, Shahar Epstein wrote: > > Great initiative Jason! > > > > > > Shahar > > > > On Mon, Feb 16, 2026, 15:58 Zhe-You(Jason) Liu <[email protected]> > wrote: > > > >> Hi everyone, > >> > >> I would like to invite new contributors looking for a "Good First Issue" > >> (everyone else is welcome too!) to help define the **Translation Agent > >> Skills for Airflow Terminology** [1]. > >> > >> We are looking to define **21 Translation Agent skills** in total. This > >> includes **1 global-level skill** and **20 locale-specific skills**. > >> > >> The goal is to implement a generic, up-to-date, and low-maintenance > >> solution using Open-standardized Agent Skills [2]. This will help the > >> Airflow community maintain translations more efficiently, ensuring > better > >> consistency across locales and reducing hallucinations in AI-assisted > >> workflows. > >> > >> The skills will be organized as follows: > >> ``` > >> .github/skills/airflow-translations > >> ├── locales > >> │ ├── ar.md > >> │ # ... all current locales, each with locale-specific skills > >> │ └── zh-TW.md > >> └── SKILL.md # Global-level Airflow terminology guidelines > >> ``` > >> > >> - **`SKILL.md`**: Contains only global-level Airflow terminology > >> guidelines. > >> - **`locales/{locale-name}.md`**: Documents guidelines specific to that > >> language, based on the existing locale files found in > >> `airflow-core/src/airflow/ui/public/i18n/locales/{locale-name}/`. > >> - **Inheritance**: All `locales/{locale-name}.md` files will depend on > the > >> global-level `SKILL.md` first. > >> > >> This is a significant milestone: these will be the **first Agent Skills > >> defined in the Airflow repository**. I am looking forward to seeing how > we > >> can leverage these skills to make our AI-assisted tools more accurate > and > >> consistent for our contribution processes. > >> > >> **How to contribute:** > >> If you are interested, please **comment on the specific sub-issue you > want > >> to work on** (rather than the meta issue), and I will assign it to you. > >> > >> Thank you in advance for your contribution! > >> > >> [1] https://github.com/apache/airflow/issues/61984 > >> [2] https://agentskills.io/home > >> > >> Best regards, > >> Jason > >> > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > >
