Fix paths in OTel.io pages, create adjust-pages patch for OTel spec

Author: chalin

content/en/docs/languages/python/propagation.md

@@ -125,7 +125,7 @@ This supports context propagation between database client and server when
 database log records are enabled. For more information, see:
 
 - [OpenTelemetry Python sqlcommenter example](https://github.com/open-telemetry/opentelemetry-python/tree/main/docs/examples/sqlcommenter/)
-- [Semantic Conventions - Database Spans](/docs/specs/semconv/database/database-spans/#sql-commenter)
+- [Semantic Conventions - Database Spans](/docs/specs/semconv/db/database-spans/#sql-commenter)
 - [sqlcommenter](https://google.github.io/sqlcommenter/)
 
 ## Next steps

content/en/docs/zero-code/java/agent/supported-libraries.md

@@ -184,7 +184,7 @@ view execution. See
 **[6]** Database client metrics are available for those who opt-in to
 [semantic convention stability](/docs/specs/semconv/non-normative/db-migration/).
 
-[Elasticsearch Client Spans]: /docs/specs/semconv/database/elasticsearch/
+[Elasticsearch Client Spans]: /docs/specs/semconv/db/elasticsearch/
 [HTTP Server Spans]: /docs/specs/semconv/http/http-spans/#http-server
 [HTTP Client Spans]: /docs/specs/semconv/http/http-spans/#http-client-span
 [HTTP Server Metrics]: /docs/specs/semconv/http/http-metrics/#http-server
@@ -194,9 +194,9 @@ view execution. See
 [RPC Server Metrics]: /docs/specs/semconv/rpc/rpc-metrics/#rpc-server
 [RPC Client Metrics]: /docs/specs/semconv/rpc/rpc-metrics/#rpc-client
 [Messaging Spans]: /docs/specs/semconv/messaging/messaging-spans/
-[Database Client Spans]: /docs/specs/semconv/database/database-spans/
-[Database Client Metrics]: /docs/specs/semconv/database/database-metrics/
-[Database Pool Metrics]: /docs/specs/semconv/database/database-metrics/
+[Database Client Spans]: /docs/specs/semconv/db/database-spans/
+[Database Client Metrics]: /docs/specs/semconv/db/database-metrics/
+[Database Pool Metrics]: /docs/specs/semconv/db/database-metrics/
 [JVM Runtime Metrics]: /docs/specs/semconv/runtime/jvm-metrics/
 [System Metrics]: /docs/specs/semconv/system/system-metrics/
 [GraphQL Server Spans]: /docs/specs/semconv/graphql/graphql-spans/

content/zh/docs/zero-code/java/agent/supported-libraries.md

@@ -1,7 +1,7 @@
 ---
 title: 支持的库
 linkTitle: 支持的库
-default_lang_commit: 1fe3f355b66260860b47b6cd79c768fd27402334
+default_lang_commit: 1fe3f355b66260860b47b6cd79c768fd27402334 # patched
 drifted_from_default: true
 weight: 11
 # prettier-ignore
@@ -173,7 +173,7 @@ Java 代理开箱即用地对许多库、框架和应用服务器进行自动插
 
 **[6]** 数据库客户端指标适用于选择加入[语义约定稳定性](/docs/specs/semconv/non-normative/db-migration/)的用户。
 
-[Elasticsearch Client Spans]: /docs/specs/semconv/database/elasticsearch/
+[Elasticsearch Client Spans]: /docs/specs/semconv/db/elasticsearch/
 [HTTP Server Spans]: /docs/specs/semconv/http/http-spans/#http-server
 [HTTP Client Spans]: /docs/specs/semconv/http/http-spans/#http-client-span
 [HTTP Server Metrics]: /docs/specs/semconv/http/http-metrics/#http-server
@@ -183,9 +183,9 @@ Java 代理开箱即用地对许多库、框架和应用服务器进行自动插
 [RPC Server Metrics]: /docs/specs/semconv/rpc/rpc-metrics/#rpc-server
 [RPC Client Metrics]: /docs/specs/semconv/rpc/rpc-metrics/#rpc-client
 [Messaging Spans]: /docs/specs/semconv/messaging/messaging-spans/
-[Database Client Spans]: /docs/specs/semconv/database/database-spans/
-[Database Client Metrics]: /docs/specs/semconv/database/database-metrics/
-[Database Pool Metrics]: /docs/specs/semconv/database/database-metrics/
+[Database Client Spans]: /docs/specs/semconv/db/database-spans/
+[Database Client Metrics]: /docs/specs/semconv/db/database-metrics/
+[Database Pool Metrics]: /docs/specs/semconv/db/database-metrics/
 [JVM Runtime Metrics]: /docs/specs/semconv/runtime/jvm-metrics/
 [System Metrics]: /docs/specs/semconv/system/system-metrics/
 [GraphQL Server Spans]: /docs/specs/semconv/graphql/graphql-spans/

scripts/content-modules/adjust-pages.pl

@@ -95,6 +95,33 @@ ($$$)
   return 0;
 }
 
+# Keep the following as a template:
+# sub patchSpec_because_of_SemConv_DockerAPIVersions() {
+#   return unless
+#     # Restrict the patch to the proper spec, and section or file:
+#     $ARGV =~ m|^tmp/semconv/docs/|
+#     &&
+#     # Call helper function that will cause the function to return early if the
+#     # current version of the named spec (arg 2) is greater than the target
+#     # version (arg 3). The first argument is a unique id that will be printed if
+#     # the patch is outdated. Otherwise, if the patch is still relevant we fall
+#     # through to the body of this patch function.
+#     applyPatchOrPrintMsgIf('2025-11-21-docker-api-versions', 'semconv', '1.39.0-dev');
+
+#   # Give infor about the patch:
+#   #
+#   # For the problematic links, see:
+#   # https://github.com/open-telemetry/semantic-conventions/issues/3103
+#   #
+#   # Replace older Docker API versions with the latest one like in:
+#   # https://github.com/open-telemetry/semantic-conventions/pull/3093
+
+#   # This is the actual regex-based patch code:
+#   s{
+#     (https://docs.docker.com/reference/api/engine/version)/v1.(43|51)/(\#tag/)
+#   }{$1/v1.52/$3}gx;
+# }
+
 sub patchSpec_because_of_SemConv_DockerAPIVersions() {
   return unless
     # Restrict the patch to the proper spec, and section or file:
@@ -121,6 +148,19 @@ ()
   }{$1/v1.52/$3}gx;
 }
 
+sub patchSpec_because_of_SemConv_DatabaseRenamedToDb() {
+  return unless
+    # Restrict the patch to the proper spec, and section or file:
+    # Note that here we replace links into semconv from the spec
+    $ARGV =~ m|^tmp/otel/specification/|
+      && applyPatchOrPrintMsgIf('2025-11-26-database-section-renamed-to-db', 'semconv', '1.39.0-dev');
+
+  # Give infor about the patch, see:
+  # https://github.com/open-telemetry/opentelemetry.io/pull/8311#issue-3577941378
+
+  s|(/semconv)/database(/database-)|$1/db$2|g;
+}
+
 sub getVersFromSubmodule() {
   my %repoNames = qw(
     otlp    opentelemetry-proto
@@ -244,6 +284,8 @@ ()
     )
   }{$otelSpecRepoUrl/tree/v$otelSpecVers/$2}gx;
 
+  patchSpec_because_of_SemConv_DatabaseRenamedToDb();
+
   s|\.\./((?:examples/)?README\.md)|$otlpSpecRepoUrl/tree/v$otlpSpecVers/$1|g if $ARGV =~ /^tmp\/otlp/;
 
   # Make website-local page references local: