Skip to content

[i18n] Update drift status for localized content#9647

Closed
vitorvasc wants to merge 7 commits intoopen-telemetry:mainfrom
vitorvasc:vitorvasc_update-drift-status
Closed

[i18n] Update drift status for localized content#9647
vitorvasc wants to merge 7 commits intoopen-telemetry:mainfrom
vitorvasc:vitorvasc_update-drift-status

Conversation

@vitorvasc
Copy link
Copy Markdown
Member

@vitorvasc vitorvasc commented Apr 14, 2026

  • I have read and followed the Contributing docs, especially the "First-time contributing?" section.
  • This PR has content that I did not fully write myself.
  • I have the experience and knowledge necessary to understand, review, and validate all content in this PR.1

Updates the drift status for localized content.

Status per locale after this PR:

Locale Drifted files Total files
bn 10 17
es 49 121
fr 40 65
ja 127 213
pl 0 1
pt 64 138
ro 5 14
uk 3 7
zh 120 198

Footnotes

  1. Yes, I can answer maintainer questions about the content of this PR, without using AI.

Signed-off-by: Vitor Vasconcellos <vvasconcellos1@gmail.com>
Signed-off-by: Vitor Vasconcellos <vvasconcellos1@gmail.com>
Signed-off-by: Vitor Vasconcellos <vvasconcellos1@gmail.com>
Signed-off-by: Vitor Vasconcellos <vvasconcellos1@gmail.com>
Signed-off-by: Vitor Vasconcellos <vvasconcellos1@gmail.com>
Signed-off-by: Vitor Vasconcellos <vvasconcellos1@gmail.com>
Signed-off-by: Vitor Vasconcellos <vvasconcellos1@gmail.com>
Copilot AI review requested due to automatic review settings April 14, 2026 12:20
@vitorvasc vitorvasc requested a review from a team as a code owner April 14, 2026 12:20
@otelbot-docs otelbot-docs Bot requested review from a team and krol3 and removed request for a team April 14, 2026 12:20
@otelbot-docs otelbot-docs Bot added the missing:docs-approval Co-owning SIG has provided approval, PR needs approval from docs maintainer label Apr 14, 2026
@otelbot-docs otelbot-docs Bot added the missing:sig-approval Co-owning SIG didn't provide an approval label Apr 14, 2026
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Updates i18n drift metadata across multiple localized pages by adding/updating the drifted_from_default front-matter field so the site/tooling can track (and eventually surface) translation drift relative to the English sources.

Changes:

  • Add drifted_from_default: true to many localized markdown pages/includes.
  • Update some pages’ drift status to drifted_from_default: file not found where the i18n script cannot locate the English counterpart by path.
  • Minor drift-status normalization on a few existing entries (e.g., switching from true to file not found).

Reviewed changes

Copilot reviewed 211 out of 211 changed files in this pull request and generated 5 comments.

Show a summary per file
File Description
content/zh/ecosystem/vendors.md Mark page as drifted from default.
content/zh/ecosystem/_includes/keep-up-to-date.md Mark include as drifted from default.
content/zh/docs/zero-code/php.md Mark page as drifted from default.
content/zh/docs/zero-code/js/configuration.md Mark page as drifted from default.
content/zh/docs/zero-code/js/_index.md Mark section index as drifted from default.
content/zh/docs/zero-code/java/spring-boot-starter/out-of-the-box-instrumentation.md Mark page as drifted from default.
content/zh/docs/zero-code/java/spring-boot-starter/getting-started.md Mark page as drifted from default.
content/zh/docs/zero-code/java/spring-boot-starter/api.md Mark page as drifted from default.
content/zh/docs/zero-code/java/spring-boot-starter/annotations.md Mark page as drifted from default.
content/zh/docs/zero-code/java/agent/server-config.md Mark page as drifted from default.
content/zh/docs/zero-code/java/agent/performance.md Mark page as drifted from default.
content/zh/docs/zero-code/java/agent/getting-started.md Mark page as drifted from default.
content/zh/docs/zero-code/java/agent/extensions.md Mark page as drifted from default.
content/zh/docs/zero-code/java/agent/configuration.md Mark page as drifted from default.
content/zh/docs/zero-code/_index.md Mark section index as drifted from default.
content/zh/docs/security/handling-sensitive-data.md Mark page as drifted from default.
content/zh/docs/platforms/kubernetes/helm/collector.md Mark page as drifted from default.
content/zh/docs/platforms/kubernetes/collector/components.md Mark page as drifted from default.
content/zh/docs/migration/opentracing.md Mark page as “file not found” vs default (drift tracking can’t locate EN by path).
content/zh/docs/migration/_index.md Update drift status to “file not found” vs default (drift tracking can’t locate EN by path).
content/zh/docs/languages/js/serverless.md Mark page as drifted from default.
content/zh/docs/languages/js/resources.md Mark page as drifted from default.
content/zh/docs/languages/js/libraries.md Mark page as drifted from default.
content/zh/docs/languages/js/instrumentation.md Mark page as drifted from default.
content/zh/docs/languages/js/getting-started/nodejs.md Mark page as drifted from default.
content/zh/docs/languages/js/benchmarks.md Mark page as drifted from default.
content/zh/docs/languages/js/_index.md Mark section index as drifted from default.
content/zh/docs/languages/js/_includes/browser-instrumentation-warning.md Mark include as drifted from default.
content/zh/docs/languages/java/getting-started.md Mark page as drifted from default.
content/zh/docs/languages/go/exporters.md Mark page as drifted from default.
content/zh/docs/languages/_index.md Mark section index as drifted from default.
content/zh/docs/languages/_includes/native-lib-alert.md Mark include as drifted from default.
content/zh/docs/languages/_includes/index-intro.md Mark include as drifted from default.
content/zh/docs/languages/_includes/exporters/zipkin-setup.md Mark include as drifted from default.
content/zh/docs/languages/_includes/exporters/prometheus-setup.md Mark include as drifted from default.
content/zh/docs/demo/kubernetes-deployment.md Mark page as drifted from default.
content/zh/docs/demo/feature-flags/recommendation-cache/index.md Mark page as drifted from default.
content/zh/docs/demo/feature-flags/_index.md Mark section index as drifted from default.
content/zh/docs/concepts/signals/baggage.md Mark page as drifted from default.
content/zh/docs/concepts/resources/index.md Mark page as drifted from default.
content/zh/docs/concepts/observability-primer.md Mark page as drifted from default.
content/zh/docs/concepts/instrumentation/_index.md Mark section index as drifted from default.
content/zh/docs/collector/resiliency.md Mark page as drifted from default.
content/zh/docs/collector/management.md Mark page as drifted from default.
content/zh/docs/collector/deploy/gateway/index.md Update drift status to “file not found” vs default (EN page exists but at a different path/filename).
content/zh/docs/_includes/exporters/intro.md Mark include as drifted from default.
content/zh/blog/2025/slack-workspace-changes.md Mark post as drifted from default.
content/ro/docs/what-is-opentelemetry.md Mark page as drifted from default.
content/ro/docs/contributing/_index.md Mark section index as drifted from default.
content/ro/docs/concepts/observability-primer.md Mark page as drifted from default.
content/pt/ecosystem/vendors.md Mark page as drifted from default.
content/pt/ecosystem/registry/updating.md Mark page as drifted from default.
content/pt/ecosystem/registry/adding.md Mark page as drifted from default.
content/pt/ecosystem/registry/_index.md Mark section index as drifted from default.
content/pt/ecosystem/integrations.md Mark page as drifted from default.
content/pt/ecosystem/distributions.md Mark page as drifted from default.
content/pt/ecosystem/adopters.md Mark page as drifted from default.
content/pt/ecosystem/_includes/keep-up-to-date.md Mark include as drifted from default.
content/pt/docs/zero-code/java/agent/api.md Mark page as drifted from default.
content/pt/docs/what-is-opentelemetry.md Mark page as drifted from default.
content/pt/docs/languages/sdk-configuration/otlp-exporter.md Mark page as drifted from default.
content/pt/docs/languages/sdk-configuration/general.md Mark page as drifted from default.
content/pt/docs/languages/sdk-configuration/_index.md Mark section index as drifted from default.
content/pt/docs/languages/python/getting-started.md Mark page as drifted from default.
content/pt/docs/languages/python/exporters.md Mark page as drifted from default.
content/pt/docs/languages/python/benchmarks.md Mark page as drifted from default.
content/pt/docs/languages/python/_index.md Mark section index as drifted from default.
content/pt/docs/languages/js/libraries.md Mark page as drifted from default.
content/pt/docs/languages/js/instrumentation.md Mark page as drifted from default.
content/pt/docs/languages/js/getting-started/nodejs.md Mark page as drifted from default.
content/pt/docs/languages/js/_index.md Mark section index as drifted from default.
content/pt/docs/languages/js/_includes/browser-instrumentation-warning.md Mark include as drifted from default.
content/pt/docs/languages/java/intro.md Mark page as drifted from default.
content/pt/docs/languages/java/instrumentation.md Mark page as drifted from default.
content/pt/docs/languages/java/getting-started.md Mark page as drifted from default.
content/pt/docs/languages/java/configuration.md Mark page as drifted from default.
content/pt/docs/languages/java/api.md Mark page as drifted from default.
content/pt/docs/languages/java/_index.md Mark section index as drifted from default.
content/pt/docs/languages/go/sampling.md Mark page as drifted from default.
content/pt/docs/languages/go/instrumentation.md Mark page as drifted from default.
content/pt/docs/languages/go/getting-started.md Mark page as drifted from default.
content/pt/docs/languages/go/exporters.md Mark page as drifted from default.
content/pt/docs/languages/go/_index.md Mark section index as drifted from default.
content/pt/docs/languages/_index.md Mark section index as drifted from default.
content/pt/docs/languages/_includes/native-lib-alert.md Mark include as drifted from default.
content/pt/docs/languages/_includes/index-intro.md Mark include as drifted from default.
content/pt/docs/languages/_includes/exporters/zipkin-setup.md Mark include as drifted from default.
content/pt/docs/languages/_includes/exporters/prometheus-setup.md Mark include as drifted from default.
content/pt/docs/contributing/style-guide.md Mark page as drifted from default.
content/pt/docs/contributing/sig-practices.md Mark page as drifted from default.
content/pt/docs/contributing/pull-requests.md Mark page as drifted from default.
content/pt/docs/contributing/pr-checks.md Mark page as drifted from default.
content/pt/docs/contributing/localization.md Mark page as drifted from default.
content/pt/docs/contributing/issues.md Mark page as drifted from default.
content/pt/docs/contributing/development.md Mark page as drifted from default.
content/pt/docs/contributing/blog.md Mark page as drifted from default.
content/pt/docs/contributing/announcements.md Mark page as drifted from default.
content/pt/docs/contributing/_index.md Mark section index as drifted from default.
content/pt/docs/concepts/signals/traces.md Mark page as drifted from default.
content/pt/docs/concepts/signals/profiles.md Mark page as drifted from default.
content/pt/docs/concepts/signals/logs.md Mark page as drifted from default.
content/pt/docs/concepts/signals/baggage.md Mark page as drifted from default.
content/pt/docs/concepts/signals/_index.md Mark section index as drifted from default.
content/pt/docs/concepts/resources/index.md Mark page as drifted from default.
content/pt/docs/concepts/observability-primer.md Mark page as drifted from default.
content/pt/docs/concepts/instrumentation/_index.md Mark section index as drifted from default.
content/pt/docs/concepts/glossary.md Mark page as drifted from default.
content/pt/docs/concepts/context-propagation/index.md Mark page as drifted from default.
content/pt/docs/_includes/exporters/intro.md Mark include as drifted from default.
content/pt/community/end-user/_index.md Mark section index as drifted from default.
content/pt/blog/2025/declarative-config.md Mark post as drifted from default.
content/pt/blog/2025/contribute-to-otel.md Mark post as drifted from default.
content/pt/_index.md Mark homepage as drifted from default.
content/ja/docs/zero-code/python/troubleshooting.md Mark page as drifted from default.
content/ja/docs/zero-code/python/operator.md Mark page as drifted from default.
content/ja/docs/zero-code/python/configuration.md Mark page as drifted from default.
content/ja/docs/zero-code/obi/setup/standalone.md Mark page as drifted from default.
content/ja/docs/zero-code/obi/setup/docker.md Mark page as drifted from default.
content/ja/docs/zero-code/obi/setup/_index.md Mark section index as drifted from default.
content/ja/docs/zero-code/js/configuration.md Mark page as drifted from default.
content/ja/docs/zero-code/js/_index.md Mark section index as drifted from default.
content/ja/docs/zero-code/java/spring-boot-starter/out-of-the-box-instrumentation.md Mark page as drifted from default.
content/ja/docs/zero-code/java/spring-boot-starter/api.md Mark page as drifted from default.
content/ja/docs/zero-code/java/quarkus.md Mark page as drifted from default.
content/ja/docs/zero-code/java/agent/getting-started.md Mark page as drifted from default.
content/ja/docs/zero-code/_index.md Mark section index as drifted from default.
content/ja/docs/what-is-opentelemetry.md Mark page as drifted from default.
content/ja/docs/security/handling-sensitive-data.md Mark page as drifted from default.
content/ja/docs/platforms/kubernetes/operator/troubleshooting/automatic.md Mark page as drifted from default.
content/ja/docs/platforms/kubernetes/operator/horizontal-pod-autoscaling.md Mark page as drifted from default.
content/ja/docs/platforms/kubernetes/collector/components.md Mark page as drifted from default.
content/ja/docs/platforms/client-apps/android/_index.md Mark page as “file not found” vs default (EN page exists but at a different path/filename).
content/ja/docs/platforms/client-apps/_index.md Mark section index as drifted from default.
content/ja/docs/languages/sdk-configuration/_index.md Mark section index as drifted from default.
content/ja/docs/languages/ruby/instrumentation.md Mark page as drifted from default.
content/ja/docs/languages/ruby/getting-started.md Mark page as drifted from default.
content/ja/docs/languages/ruby/_index.md Mark section index as drifted from default.
content/ja/docs/languages/js/getting-started/nodejs.md Mark page as drifted from default.
content/ja/docs/languages/js/benchmarks.md Mark page as drifted from default.
content/ja/docs/languages/js/_includes/browser-instrumentation-warning.md Mark include as drifted from default.
content/ja/docs/languages/java/getting-started.md Mark page as drifted from default.
content/ja/docs/languages/java/_index.md Mark section index as drifted from default.
content/ja/docs/languages/go/exporters.md Mark page as drifted from default.
content/ja/docs/languages/_index.md Mark section index as drifted from default.
content/ja/docs/languages/_includes/native-lib-alert.md Mark include as drifted from default.
content/ja/docs/languages/_includes/index-intro.md Mark include as drifted from default.
content/ja/docs/languages/_includes/exporters/zipkin-setup.md Mark include as drifted from default.
content/ja/docs/languages/_includes/exporters/prometheus-setup.md Mark include as drifted from default.
content/ja/docs/demo/kubernetes-deployment.md Mark page as drifted from default.
content/ja/docs/concepts/signals/traces.md Mark page as drifted from default.
content/ja/docs/concepts/signals/baggage.md Mark page as drifted from default.
content/ja/docs/concepts/signals/_index.md Mark section index as drifted from default.
content/ja/docs/concepts/resources/index.md Mark page as drifted from default.
content/ja/docs/concepts/observability-primer.md Mark page as drifted from default.
content/ja/docs/concepts/instrumentation/_index.md Mark section index as drifted from default.
content/ja/docs/concepts/glossary.md Mark page as drifted from default.
content/ja/docs/concepts/context-propagation/index.md Mark page as drifted from default.
content/ja/docs/collector/management.md Mark page as drifted from default.
content/ja/docs/collector/install/kubernetes.md Mark page as drifted from default.
content/ja/docs/collector/install/docker.md Mark page as drifted from default.
content/ja/docs/collector/install/binary/windows.md Mark page as drifted from default.
content/ja/docs/collector/install/binary/macos.md Mark page as drifted from default.
content/ja/docs/collector/install/binary/linux.md Mark page as drifted from default.
content/ja/docs/collector/install/_index.md Mark section index as drifted from default.
content/ja/docs/collector/extend/ocb.md Mark page as drifted from default.
content/ja/docs/collector/extend/custom-component/extension/authenticator.md Mark page as drifted from default.
content/ja/docs/collector/extend/custom-component/_index.md Mark section index as drifted from default.
content/ja/docs/collector/deploy/other/no-collector.md Mark page as drifted from default.
content/ja/docs/collector/deploy/gateway/index.md Mark page as “file not found” vs default (EN page exists but at a different path/filename).
content/ja/docs/collector/deploy/agent.md Mark page as drifted from default.
content/ja/docs/collector/deploy/_index.md Mark section index as drifted from default.
content/ja/docs/_includes/exporters/intro.md Mark include as drifted from default.
content/ja/blog/2025/kubecon-japan.md Mark post as drifted from default.
content/ja/blog/2025/ai-agent-observability/index.md Mark post as drifted from default.
content/ja/announcements/kubecon-japan.md Mark announcement as drifted from default.
content/ja/_includes/otel-does-not-validate-3rd-pty-distros.md Mark include as drifted from default.
content/fr/docs/zero-code/php.md Mark page as drifted from default.
content/fr/docs/zero-code/java/spring-boot-starter/out-of-the-box-instrumentation.md Mark page as drifted from default.
content/fr/docs/zero-code/java/spring-boot-starter/api.md Mark page as drifted from default.
content/fr/docs/zero-code/java/quarkus.md Mark page as drifted from default.
content/fr/docs/zero-code/java/agent/performance.md Mark page as drifted from default.
content/fr/docs/zero-code/java/agent/extensions.md Mark page as drifted from default.
content/fr/docs/zero-code/java/agent/configuration.md Mark page as drifted from default.
content/fr/docs/zero-code/dotnet/custom.md Mark page as drifted from default.
content/fr/docs/platforms/kubernetes/operator/troubleshooting/automatic.md Mark page as drifted from default.
content/fr/docs/platforms/kubernetes/operator/horizontal-pod-autoscaling.md Mark page as drifted from default.
content/fr/docs/concepts/signals/traces.md Mark page as drifted from default.
content/fr/docs/concepts/observability-primer.md Mark page as drifted from default.
content/es/ecosystem/registry/_index.md Mark section index as drifted from default.
content/es/docs/zero-code/go/autosdk.md Mark page as drifted from default.
content/es/docs/zero-code/dotnet/custom.md Mark page as drifted from default.
content/es/docs/zero-code/_index.md Mark section index as drifted from default.
content/es/docs/demo/kubernetes-deployment.md Mark page as drifted from default.
content/es/docs/demo/feature-flags/recommendation-cache/index.md Mark page as drifted from default.
content/es/docs/demo/feature-flags/_index.md Mark section index as drifted from default.
content/es/docs/contributing/style-guide.md Mark page as drifted from default.
content/es/docs/contributing/sig-practices.md Mark page as drifted from default.
content/es/docs/contributing/pull-requests.md Mark page as drifted from default.
content/es/docs/contributing/pr-checks.md Mark page as drifted from default.
content/es/docs/contributing/localization.md Mark page as drifted from default.
content/es/docs/contributing/development.md Mark page as drifted from default.
content/es/docs/contributing/blog.md Mark page as drifted from default.
content/es/docs/contributing/_index.md Mark section index as drifted from default.
content/es/docs/concepts/signals/baggage.md Mark page as drifted from default.
content/es/docs/concepts/signals/_index.md Mark section index as drifted from default.
content/es/docs/concepts/resources/index.md Mark page as drifted from default.
content/es/docs/concepts/observability-primer.md Mark page as drifted from default.
content/es/docs/concepts/instrumentation/_index.md Mark section index as drifted from default.
content/es/_index.md Mark homepage as drifted from default.
content/bn/docs/demo/kubernetes-deployment.md Mark page as drifted from default.
content/bn/docs/concepts/signals/_index.md Mark section index as drifted from default.

linkTitle: OpenTracing
weight: 2
default_lang_commit: 0b7c6aeafe53e44fdeb64ed2c7bdb42e88f35802
drifted_from_default: file not found
Copy link

Copilot AI Apr 14, 2026

Choose a reason for hiding this comment

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

drifted_from_default: file not found is likely caused by the localized page living at docs/migration/... while the English source page now lives at content/en/docs/compatibility/migration/opentracing.md. If the English page still exists, consider moving/renaming this localized file to mirror the English path (and keep the old URL via aliases/redirects) so drift tracking can work and this status doesn’t read as if the source page was removed.

Copilot uses AI. Check for mistakes.
weight: 950
default_lang_commit: 4b1f5e382758278e1e56e7b197bd349c17fdf9cb
drifted_from_default: true
drifted_from_default: file not found
Copy link

Copilot AI Apr 14, 2026

Choose a reason for hiding this comment

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

drifted_from_default: file not found appears to come from a path mismatch: the English migration index exists at content/en/docs/compatibility/migration/_index.md (with /docs/migration/ as an alias), but this localized page is at content/zh/docs/migration/_index.md. Consider moving this page under docs/compatibility/migration/ (and keeping an alias for the old path) so the i18n tooling can locate the default-language counterpart and report drift accurately.

Copilot uses AI. Check for mistakes.
weight: 3
default_lang_commit: 219d54eb41a768f8fa6058616177e58032d089b5 # patched
drifted_from_default: true
drifted_from_default: file not found
Copy link

Copilot AI Apr 14, 2026

Choose a reason for hiding this comment

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

drifted_from_default: file not found is probably due to a filename mismatch: the English page is content/en/docs/collector/deploy/gateway.md (not .../gateway/index.md). Consider renaming/moving this localized page to content/zh/docs/collector/deploy/gateway.md (and adding aliases for the old URL if needed) so the drift checker can find the English counterpart.

Copilot uses AI. Check for mistakes.
title: Android
# description:
default_lang_commit: 9b427bf25703c33a2c6e05c2a7b58e0f768f7bad
drifted_from_default: file not found
Copy link

Copilot AI Apr 14, 2026

Choose a reason for hiding this comment

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

drifted_from_default: file not found looks like a path mismatch: the English Android page is content/en/docs/platforms/client-apps/android.md (single file), while this localized version is .../android/_index.md. Consider renaming/moving this page to android.md (and keeping an alias/redirect for the old path) so the i18n drift tooling can resolve the default-language source correctly.

Copilot uses AI. Check for mistakes.
aliases: [/docs/collector/deployment/gateway]
weight: 300
default_lang_commit: 4cb7e22f1e45d17854b309efc730499880aa7197 # patched
drifted_from_default: file not found
Copy link

Copilot AI Apr 14, 2026

Choose a reason for hiding this comment

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

drifted_from_default: file not found is likely due to the English page being content/en/docs/collector/deploy/gateway.md rather than .../gateway/index.md. Consider moving/renaming this localized file to gateway.md (and adding aliases/redirects if necessary) so the default-language page is discoverable and drift status is meaningful.

Copilot uses AI. Check for mistakes.
@vitorvasc vitorvasc closed this Apr 30, 2026
@vitorvasc vitorvasc deleted the vitorvasc_update-drift-status branch April 30, 2026 10:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

lang:bn lang:es lang:fr lang:ja lang:pt lang:ro lang:zh missing:docs-approval Co-owning SIG has provided approval, PR needs approval from docs maintainer missing:sig-approval Co-owning SIG didn't provide an approval

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

4 participants