Merge branch 'main' into patch-2

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,21 @@
+<!--
+Please provide a meaningful description of what your changes will do. Bonus points for including links to related issues, other PRs, or technical references.
+
+A detailed description helps reviewers understand the context of your change and reduces
+the time needed to review.
+
+Please make sure to follow the [contribution guidelines](https://opentelemetry.io/docs/contributing/).
+
+We run checks on all PRs, to ensure that your contribution follows our [style guide](https://opentelemetry.io/docs/contributing/style-guide/).
+
+Many requirements of that guide can be enforced by running `npm run fix:all` locally and committing the changes.
+
+Note, that although those checks need to be green before we can merge your PR, do not
+worry about their status after submitting your PR. We will provide you with guidance, when and how to
+address them.
+
+Similarly, do not worry about your PR being out-of-date with the base branch and do not continuously
+update or rebase your branch. We will let you know when it is necessary.
+
+If you have any questions, feel free to ask.
+-->

.htmltest.yml

@@ -15,14 +15,6 @@ IgnoreDirs:
   - ^es/docs/concepts/instrumentation/zero-code/
   - ^es/docs/concepts/signals/baggage/
   - ^es/docs/zero-code/php/
-  # TODO drop next lines after https://github.com/open-telemetry/opentelemetry.io/issues/5555 is fixed for these pages:
-  - ^ja/docs/concepts/components/
-  - ^ja/docs/concepts/glossary/
-  - ^ja/docs/concepts/signals/baggage/
-  - ^ja/docs/languages/erlang/sampling/
-  - ^ja/docs/languages/js/sampling/
-  - ^ja/docs/languages/ruby/sampling/
-  - ^ja/docs/zero-code/php/
   # TODO drop next line after https://github.com/open-telemetry/opentelemetry.io/issues/5423 is fixed for ja pages:
   - ^ja/docs/concepts/instrumentation/libraries/
   # TODO drop next lines after https://github.com/open-telemetry/opentelemetry.io/issues/5555 is fixed for these pages:
@@ -81,6 +73,7 @@ IgnoreURLs: # list of regexs of paths or URLs to be ignored
   - ^https://www.farfetch.com
   - ^https://www.zocdoc.com
   - ^https://x.com
+  - ^https://maven.org
   # OTel Google calendar - curl returns 200, but the link checker gets a 401:
   - ^https://calendar.google.com/calendar/embed\?src=google.com_b79e3e90j7bbsa2n2p5an5lf60%40group.calendar.google.com
   # YouTube playlists sometimes give a 404, although they give a 200 when accessed via browser:

content/ja/docs/_index.md

@@ -1,16 +1,6 @@
 ---
 title: ドキュメント
 menu: { main: { weight: 10 } }
-htmltest:
-  IgnoreDirs:
-    # TODO drop next lines after https://github.com/open-telemetry/opentelemetry.io/issues/5555 is fixed for these pages:
-    - ^ja/docs/concepts/components/
-    - ^ja/docs/concepts/glossary/
-    - ^ja/docs/concepts/signals/baggage/
-    - ^ja/docs/languages/erlang/sampling/
-    - ^ja/docs/languages/js/sampling/
-    - ^ja/docs/languages/ruby/sampling/
-    - ^ja/docs/zero-code/php/
 default_lang_commit: c2cd5b14
 ---
 

content/ja/docs/concepts/context-propagation.md

@@ -10,14 +10,14 @@ default_lang_commit: 313e391
 
 コンテキストの伝播を理解するには、コンテキストと伝搬（プロパゲーション）という、2つの別々の概念を理解する必要があります。
 
-## コンテキスト
+## コンテキスト {#context}
 
 コンテキストは、送受信サービスまたは[実行ユニット](/docs/specs/otel/glossary/#execution-unit)が、あるシグナルと別のシグナルを関連付けるための情報を含むオブジェクトです。
 
 たとえば、サービスAがサービスBを呼び出した場合、IDがコンテキスト内にあるサービスAのスパンは、サービスBで次に作成されるスパンの親スパンとして使用されます。
 コンテキスト内にあるトレースIDは、サービスBで次に作成されるスパンにも使用されるため、そのスパンはサービスAのスパンと同じトレースの一部であることを意味します。
 
-## 伝搬（プロパゲーション）
+## 伝搬（プロパゲーション） {#propagation}
 
 伝搬は、サービスとプロセス間でコンテキストを移動させる仕組みです。
 コンテキストオブジェクトをシリアライズまたはデシリアライズし、あるサービスから別のサービスに伝搬される関連情報を提供します。

content/ja/docs/concepts/sampling/index.md

@@ -35,7 +35,7 @@ _適切なデータのサンプリングが必要なだけです。_
 誰かが「データをサンプリングアウトしている」と言ったり、処理またはエクスポートされていないデータは「サンプリングされた」と見なされると言ったりするのを見かけるかもしれません。
 これらは間違った表現です。
 
-## ヘッドサンプリング
+## ヘッドサンプリング {#head-sampling}
 
 ヘッドサンプリングは、サンプリングの決定をできるだけ早期に行うために用いられるサンプリング技術です。
 スパンやトレースのサンプリングまたはドロップの決定は、トレース全体を検査することによって行われるわけではありません。

content/ja/docs/what-is-opentelemetry.md

@@ -66,7 +66,7 @@ OpenTelemetryは拡張できるように設計されています。どのよう
 
 ほとんどのユーザーはOpenTelemetryを拡張する必要はないかもしれませんが、このプロジェクトはほぼすべてのレベルで拡張できるように設計されています。
 
-## 歴史
+## 歴史 {#history}
 
 OpenTelemetryは、[Cloud Native Computing Foundation (CNCF)](https://www.cncf.io)プロジェクトであり、[OpenTracing](https://opentracing.io)と[OpenCensus](https://opencensus.io)の2つのプロジェクトが統合された成果物です。
 これらのプロジェクトはどちらも、コードを計装し、オブザーバビリティバックエンドにテレメトリーデータを送信する方法の標準がないという問題を解決するために作られました。

data/registry/instrumentation-java-okhttp.yml

@@ -1,3 +1,4 @@
+# cspell:ignore okhttp
 title: okHTTP Instrumentation
 registryType: instrumentation
 language: java
@@ -13,4 +14,8 @@ authors:
 urls:
   repo: https://github.com/open-telemetry/opentelemetry-java-instrumentation/tree/main/instrumentation/okhttp
 createdAt: 2020-11-05
+package:
+  registry: maven
+  name: io.opentelemetry.instrumentation/opentelemetry-okhttp-3.0
+  version: 2.9.0-alpha
 isFirstParty: false

layouts/partials/ecosystem/registry/entry.html

@@ -46,6 +46,10 @@
                 "installLine" "cargo add %s"
                 "installTemplate" "ecosystem/registry/quickinstall/default.md"
                 "icon" "fab fa-rust")
+            "maven" (dict
+                "urlPattern" "https://maven.org/artifact/%s"
+                "installTemplate" "ecosystem/registry/quickinstall/maven.md"
+                "icon" "fa-solid fa-feather")
     -}}
 
     {{ $isNative := and (or (eq .registryType "instrumentation") (eq .registryType "application integration")) (.isNative) }}
@@ -157,6 +161,19 @@ <h4 class="alert-heading">Deprecated</h4>
                     {{ end -}}
                     {{- .description | markdownify -}}
                 </div>
+
+                <!-- New Tags section -->
+                <div class="tags mb-2">
+                    {{ if .tags }}
+                        <div>
+                            {{ range .tags }}
+                                {{ $tag := . }} <!-- Store the tag in a variable -->
+                                <a href="/ecosystem/registry/?s={{ $tag | urlize }}" class="badge bg-light me-1">{{ $tag }}</a>
+                            {{ end }}
+                        </div>
+                    {{ end }}
+                </div>
+
                 {{ with $package -}}
                     {{ if not (eq .quickInstall false) }}
                     <h6><i class="fa-solid fa-forward"></i> Quick Install</h6>

layouts/partials/ecosystem/registry/quickinstall/maven.md

@@ -0,0 +1,21 @@
+##### Maven
+
+Add the following dependency in your `pom.xml` file to install this package.
+
+```xml
+<dependency>
+    <groupId>{{ index (split .name "/") 0 }}</groupId>
+    <artifactId>{{ index (split .name "/") 1 }}</artifactId>
+    <version>{{ .version }}</version>
+</dependency>
+```
+
+##### Gradle
+
+Add the following dependency in your `build.gradle` file to install this package:
+
+```groovy
+dependencies {
+ implementation '{{ index (split .name "/") 0 }}:{{ index (split .name "/") 1 }}:{{ .version }}'
+}
+```

scripts/content-modules/adjust-pages.pl

@@ -25,7 +25,7 @@
 my $otelSpecVers = $versions{'spec:'};
 my $otlpSpecVers = $versions{'otlp:'};
 my $semconvVers = $versions{'semconv:'};
-my $warn2 = 0; # TODO remove along with warning 002
+my $patchMsg2 = 0; # TODO remove along with patch-message 002
 
 sub printTitleAndFrontMatter() {
   print "---\n";
@@ -46,7 +46,7 @@ ()
   } elsif ($ARGV =~ /otel\/specification\/logs\/api.md$/) {
     if ($otelSpecVers ne "1.39.0") {
       # TODO: delete the enclosing elsif body
-      print STDOUT "WARNING [001]: $0: remove obsolete code now that OTel spec has been updated.\n"
+      print STDOUT "INFO [001]: $0: remove obsolete code now that OTel spec has been updated.\n"
     }
     $frontMatterFromFile .= "linkTitle: API\naliases: [bridge-api]\n";
   }
@@ -116,13 +116,13 @@ ()
 
   # SPECIFICATION custom processing
 
-  # TODO: drop the entire if-then-else statement patch code when OTel spec vers contains
+  # TODO: drop the entire if statement patch code when OTel spec vers contains
   # https://github.com/open-telemetry/opentelemetry-specification/pull/4287,
   # which should be vers > 1.39.0.
-  if ($otelSpecVers eq "1.39.0") {
+  if ($ARGV =~ /otel\/spec/) {
     s|(/api\.md)#logs-api\b|$1|g;
-  } elsif ($ARGV =~ /otel\/spec/) {
-    print STDOUT "WARNING [002]: $0: remove obsolete code now that OTel spec has been updated.\n" unless $warn2++
+    print STDOUT "INFO [002]: $0: remove obsolete patch code now that OTel spec has been updated.\n"
+      if $otelSpecVers ne "1.39.0" && !$patchMsg2++
   }
 
   s|\(https://github.com/open-telemetry/opentelemetry-specification\)|($specBasePath/otel/)|;