Skip to content

Add initial Portuguese (pt) translation agent skill (#62001)#62083

Open
Jayantparashar10 wants to merge 1 commit intoapache:mainfrom
Jayantparashar10:add-pt-translation-skill
Open

Add initial Portuguese (pt) translation agent skill (#62001)#62083
Jayantparashar10 wants to merge 1 commit intoapache:mainfrom
Jayantparashar10:add-pt-translation-skill

Conversation

@Jayantparashar10
Copy link

Description

This PR creates the Portuguese (pt) translation agent skill file as part of the broader initiative to help AI agents produce consistent translations for Airflow's UI.

Changes

  • Creates .github/skills/airflow-translations/locales/pt.md with comprehensive Portuguese translation guidelines
  • Adds minimal placeholder .github/skills/airflow-translations/SKILL.md for global terminology rules (to be completed in Define global-level translation agent skills #61985)
  • Provides real-world examples extracted from existing airflow-core/src/airflow/ui/public/i18n/locales/pt/*.json files

Content Overview

The pt.md skill file includes:

  1. Core Airflow Terminology - Terms that must remain in English (Dag, Asset, Backfill, XCom, etc.)
  2. Portuguese-Specific Guidelines - Gender agreement, plural forms, capitalization, spelling conventions
  3. Translation Examples - Real patterns from existing JSON files showing correct translations
  4. Agent Instructions - Clear DO/DON'T rules for AI translation agents

Testing Strategy

After merge, any AI agent supporting "skills" context can:

  1. Load this file as reference material
  2. Receive new English UI strings for translation
  3. Output Portuguese translations matching existing style/conventions

Example test case:

  • Input: "retry_delay": "Retry delay in seconds"
  • Expected: "retry_delay": "Atraso de retentativa em segundos"
  • Validation: Matches Portuguese style from existing files

Alignment

Closes: #62001

Was generative AI tooling used to co-author this PR?
  • Yes (please specify the tool below)

@boring-cyborg
Copy link

boring-cyborg bot commented Feb 17, 2026

Congratulations on your first Pull Request and welcome to the Apache Airflow community! If you have any issues or are unsure about any anything please check our Contributors' Guide (https://github.com/apache/airflow/blob/main/contributing-docs/README.rst)
Here are some useful points:

  • Pay attention to the quality of your code (ruff, mypy and type annotations). Our prek-hooks will help you with that.
  • In case of a new feature add useful documentation (in docstrings or in docs/ directory). Adding a new operator? Check this short guide Consider adding an example DAG that shows how users should use it.
  • Consider using Breeze environment for testing locally, it's a heavy docker but it ships with a working Airflow and a lot of integrations.
  • Be patient and persistent. It might take some time to get a review or get the final approval from Committers.
  • Please follow ASF Code of Conduct for all communication including (but not limited to) comments on Pull Requests, Mailing list and Slack.
  • Be sure to read the Airflow Coding style.
  • Always keep your Pull Requests rebased, otherwise your build might fail due to changes not related to your commits.
    Apache Airflow is a community-driven project and together we are making it better 🚀.
    In case of doubts contact the developers at:
    Mailing List: dev@airflow.apache.org
    Slack: https://s.apache.org/airflow-slack

@boring-cyborg boring-cyborg bot added area:dev-tools backport-to-v3-1-test Mark PR with this label to backport to v3-1-test branch labels Feb 17, 2026
@Jayantparashar10
Copy link
Author

Hi @jason810496,

Opened this as a draft PR with the initial pt.md content based on the existing Portuguese JSON files.

Happy to adjust any vocabulary, add/remove examples, or refine the rules based on feedback from Portuguese maintainers.

Thanks again for the assignment and guidance!

@Jayantparashar10 Jayantparashar10 marked this pull request as ready for review February 18, 2026 08:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:dev-tools backport-to-v3-1-test Mark PR with this label to backport to v3-1-test branch

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Define translation agent skill guidelines for Portuguese (pt) locale

1 participant