Skip to content

[ES] Proposal to include an i18n conventions file#17083

Merged
istio-testing merged 2 commits intoistio:masterfrom
josunect:languages_conventions
Jan 21, 2026
Merged

[ES] Proposal to include an i18n conventions file#17083
istio-testing merged 2 commits intoistio:masterfrom
josunect:languages_conventions

Conversation

@josunect
Copy link
Copy Markdown
Contributor

@josunect josunect commented Jan 8, 2026

Description

Translated documents are usually quite long, and it’s common to find different terms used for the same concept. Because of that, it would be useful to have a document where we define conventions and guidelines per language.
Since these translations often rely on AI, we could create a file like i18n-agents-locale.md per language to capture those conventions and help keep things consistent.

Also normalize terms based on the conventions.

Note: The Spanish terms used are a proposal, any suggestion is welcome.

Reviewers

  • Ambient
  • Docs
  • Installation
  • Networking
  • Performance and Scalability
  • Extensions and Telemetry
  • Security
  • Test and Release
  • User Experience
  • Developer Infrastructure
  • Localization/Translation

@istio-testing
Copy link
Copy Markdown
Contributor

Skipping CI for Draft Pull Request.
If you want CI signal for your change, please convert it to an actual PR.
You can still manually trigger a test run with /test all

@istio-testing istio-testing added do-not-merge/work-in-progress Block merging of a PR because it isn't ready yet. size/L Denotes a PR that changes 100-499 lines, ignoring generated files. labels Jan 8, 2026
Signed-off-by: josunect <jcordoba@redhat.com>
@josunect josunect self-assigned this Jan 8, 2026
@josunect josunect requested a review from fjglira January 8, 2026 12:29
@josunect josunect marked this pull request as ready for review January 8, 2026 12:29
@josunect josunect requested review from a team as code owners January 8, 2026 12:29
@istio-testing istio-testing removed the do-not-merge/work-in-progress Block merging of a PR because it isn't ready yet. label Jan 8, 2026
Copy link
Copy Markdown
Contributor

@fjglira fjglira left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I really like this, thanks a lot @josunect. I think we need also approval from the main maintainer group because it's adding files outside the spanish folder

Comment thread I18N-AGENTS-ES.md
## Style guidelines (Spanish)

- **Voice**: prefer second-person informal already used across the site (“tú/tu”), unless the page clearly uses another voice.
- **Clarity**: short sentences; avoid overly literal calques from English.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

calques?

Copy link
Copy Markdown
Contributor

@keithmattix keithmattix left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM - great idea!

@istio-testing istio-testing merged commit 4781229 into istio:master Jan 21, 2026
6 checks passed
@josunect josunect deleted the languages_conventions branch January 21, 2026 13:38
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants