This is an automated email from the ASF dual-hosted git repository.
bbovenzi pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/main by this push:
new 8a119894a17 Document Italian translation conventions (#75727)
8a119894a17 is described below
commit 8a119894a178bfd56ab60bd1deff981d0f2a73b9
Author: Deepak Jain (DJ) <[email protected]>
AuthorDate: Mon Nov 9 06:18:22 2026 -0800
Document Italian translation conventions (#75727)
Italian translation updates need consistent terminology and grammar while
preserving Airflow identifiers and interpolation tokens. Related: #61996.
Signed-off-by: Deepak Jain <[email protected]>
---
.agents/skills/airflow-translations/locales/it.md | 28 ++++++++++++++++++
.../airflow/ui/public/i18n/locales/it/README.md | 34 ++++++++++++++++++++++
2 files changed, 62 insertions(+)
diff --git a/.agents/skills/airflow-translations/locales/it.md
b/.agents/skills/airflow-translations/locales/it.md
index 0533bc9cbac..8b46590b82f 100644
--- a/.agents/skills/airflow-translations/locales/it.md
+++ b/.agents/skills/airflow-translations/locales/it.md
@@ -22,6 +22,26 @@ the word for a deadline. A loop is `Ciclo`; one pass of it
is `Iterazione`.
Do not copy an awkward existing string into a new key. `Mostrando`, for
example, is not Italian.
+## Grammar and interface text
+
+Use Italian articles and prepositions around technical terms: `del Dag`,
+`del Task`, `della connessione` and `dell'operatore`. Match gender and number
to
+the Italian noun in the sentence, including when a placeholder supplies its
value.
+
+The Italian translation owner's feedback in
+[the earlier Italian guidelines
PR](https://github.com/apache/airflow/pull/62685)
+prefers `Ultima esecuzione del Dag` for a new label describing the latest Dag
+run, and `ID della connessione` for a connection identifier. Existing short
+labels such as `Run del Dag` remain in use; do not copy `Ultimo Run del Dag`
+or `ID Connessione` into new prose merely because they occur in older strings.
+
+Use direct action labels, following the existing interface: `Aggiungi`,
+`Modifica`, `Elimina`, `Salva` and `Scarica`.
+
+Use sentence case for new sentences and preserve established labels in their
+existing context. Keep accents, including `è`, `ì` and `à`, and use the Italian
+apostrophe where needed, as in `L'ID della connessione è obbligatorio`.
+
## Plurals
Italian needs `_zero`, `_one`, `_many` and `_other`
@@ -64,3 +84,11 @@ unaffected:
The UI prints the count as digits (`1.000.000`), not as the words "un milione".
Keep `{{count, number}}` anyway: that is the form i18next selects `_many` for.
+
+## Before submitting
+
+- Check the English key and nearby Italian strings before translating.
+- Reuse the terminology above and preserve interpolation tokens exactly.
+- Follow the validation commands in the parent skill.
+- Keep terminology corrections separate from unrelated translation updates and
+ explain them to the Italian translation owners during review.
diff --git a/airflow-core/src/airflow/ui/public/i18n/locales/it/README.md
b/airflow-core/src/airflow/ui/public/i18n/locales/it/README.md
new file mode 100644
index 00000000000..6e09c35a02e
--- /dev/null
+++ b/airflow-core/src/airflow/ui/public/i18n/locales/it/README.md
@@ -0,0 +1,34 @@
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+ -->
+
+<!-- SPDX-License-Identifier: Apache-2.0
+ https://www.apache.org/licenses/LICENSE-2.0 -->
+
+# Italian translations
+
+The Italian interface keeps familiar Airflow terms such as `Dag`, `Task`,
+`XCom`, `Asset` and `Pool` in English so they remain recognizable alongside
+code and documentation. Interface actions and general concepts use Italian,
+including `Elimina`, `Salva`, `Connessione` and `Variabile`.
+
+Use Italian grammar around technical names, such as `del Dag` and
+`della connessione`. Existing strings include older wording; consult the
+[Italian translation
guidelines](../../../../../../../../.agents/skills/airflow-translations/locales/it.md)
+for the glossary, plural forms and the Italian translation owner's corrections
+from earlier reviews.
