opentelemetry.io icon indicating copy to clipboard operation
opentelemetry.io copied to clipboard

[pt] Fix link definition labels for Portuguese localizations

Open vitorvasc opened this issue 7 months ago • 6 comments

Description

What needs to be changed?

As the definitions for translating the labels on link definitions were updated:

Originally posted by @chalin in https://github.com/open-telemetry/opentelemetry.io/issues/6698#issuecomment-2858793234

... we've formalized the guidance that link definition labels should not be translated, as described in the added guidance via:

  • #6838

And since this is a rule that applies for all pages:

Yes, it is a general rule as documented in https://opentelemetry.io/docs/contributing/localization/#link-labels.

Originally posted by @chalin in #6839

We must review the Portuguese pages where the definition labels were translated and revert its definitions to the original wording.

What is the name + path of the page that needs changed?

So far, I've identified some pages where this fix must be applied:

  • [x] content/pt/docs/concepts/instrumentation/libraries.md
  • [x] content/pt/docs/concepts/signals/_index.md
  • [x] content/pt/docs/concepts/signals/baggage.md
  • [x] content/pt/docs/concepts/signals/logs.md
  • [x] content/pt/docs/concepts/distributions.md
  • [ ] content/pt/docs/contributing/_index.md
  • [ ] content/pt/docs/getting-started/_index.md
  • [ ] content/pt/docs/languages/js/getting-started/nodejs.md
  • [ ] content/pt/docs/languages/python/getting-started.md
  • [ ] content/pt/docs/languages/_index.md
  • [ ] content/pt/ecosystem/_includes/keep-up-to-date.md
  • [ ] content/pt/ecosystem/registry/adding.md
  • [ ] content/pt/ecosystem/registry/updating.md
  • [ ] content/pt/ecosystem/adopters.md
  • [ ] content/pt/ecosystem/distributions.md
  • [ ] content/pt/ecosystem/integrations.md
  • [ ] content/pt/ecosystem/vendors.md
  • [ ] content/pt/_index.md

How to contribute

  1. Read this guide to familiarize yourself with the contribution process.
  2. Comment on this issue about which page you want to localize.
  3. If you have any questions, let us know at #otel-localization-ptbr.

vitorvasc avatar May 13 '25 18:05 vitorvasc

IMHO, this can be done progressively as changes are introduced to the corresponding en pages. It is up to you. Thanks for tracking this requirement.

chalin avatar May 13 '25 19:05 chalin

@chalin no worries!

I'll try to update one or two pages per day. Besides the drifted pages that might be on the list, it should be simple to tackle this list.

vitorvasc avatar May 15 '25 15:05 vitorvasc

@vitorvasc - can you put a hold on this for now? I'd like to discuss further with the other maintainers.

chalin avatar May 16 '25 12:05 chalin

@chalin sure! Adding the blocked tag then.

vitorvasc avatar May 16 '25 14:05 vitorvasc

After more careful consideration, we're allowing locales to choose whether they want to translate labels. Sorry for the churn. Thanks for your understanding as we refine our processes. @vitorvasc - I leave it up to you to close this issue or continue working on it.

chalin avatar Jul 31 '25 13:07 chalin

Mentioning the @open-telemetry/docs-pt-approvers for thoughts on this.

[...]we're allowing locales to choose whether they want to translate labels. [...]

Our current scenario: we've always translated the definition labels, and most of our pages include these translations.

Should we standardize it and continue working on this issue? Or does it make more sense to leave the labels as they are and keep translating them, as usual?

vitorvasc avatar Jul 31 '25 14:07 vitorvasc