Merge java libraries into intrumentation ecosystem

Author: jack-berg

content/en/docs/languages/java/instrumentation.md

@@ -5,6 +5,7 @@ aliases:
   - /docs/java/manual_instrumentation
   - manual
   - manual_instrumentation
+  - /docs/languages/java/libraries/
 weight: 10
 description: Instrumentation ecosystem in OpenTelemetry Java
 cSpell:ignore: Logback logback
@@ -63,8 +64,9 @@ Library instrumentation.
 
 ### Zero-code: Java agent
 
-The Java agent is a form of zero-code instrumentation that dynamically
-manipulations application bytecode.
+The Java agent is a form of zero-code
+[automatic instrumentation](/docs/specs/otel/glossary/#automatic-instrumentation)
+that dynamically manipulations application bytecode.
 
 For a list of libraries instrumented by the Java agent, see the
 "Auto-instrumented versions" column on
@@ -74,38 +76,41 @@ See [Java agent](/docs/zero-code/java/agent/) for more details.
 
 ### Zero-code: Spring Boot starter
 
-The Spring Boot starter is a form of zero-code instrumentation that leverages
-spring autoconfigure to install
+The Spring Boot starter is a form of zero-code
+[automatic instrumentation](/docs/specs/otel/glossary/#automatic-instrumentation)
+that leverages spring autoconfigure to install
 [library instrumentation](#library-instrumentation).
 
 See [Spring Boot starter](/docs/zero-code/java/spring-boot-starter/) for
 details.
 
 ### Library instrumentation
 
-Library instrumentation wraps or uses extension points to instrument a library,
-requiring users to install and/or adapt library usage.
+[Library instrumentation](/docs/specs/otel/glossary/#instrumentation-library)
+wraps or uses extension points to instrument a library, requiring users to
+install and/or adapt library usage.
 
 For a list of instrumentation libraries, see the "Standalone Library
 Instrumentation" column on
 [supported libraries](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md).
 
 ### Native instrumentation
 
-Native instrumentation is built directly into libraries or frameworks.
-OpenTelemetry encourages library authors to add native instrumentation using the
-[API](../api-components/). In the long term, we hope the native instrumentation
-becomes the norm, and view the instrumentation maintained by OpenTelemetry in
+[Native instrumentation](/docs/specs/otel/glossary/#natively-instrumented) is
+built directly into libraries or frameworks. OpenTelemetry encourages library
+authors to add native instrumentation using the [API](../api-components/). In
+the long term, we hope the native instrumentation becomes the norm, and view the
+instrumentation maintained by OpenTelemetry in
 [opentelemetry-java-instrumentation](https://github.com/open-telemetry/opentelemetry-java-instrumentation)
 as a temporary means of filling the gap.
 
-For a list of libraries with native instrumentation, look for entries with the
-"native" badge in the [registry](/ecosystem/registry/?language=java).
+{{% docs/languages/native-libraries "java" %}}
 
 ### Manual instrumentation
 
-Manual instrumentation is written by application authors, and typically specific
-to the application domain.
+[Manual instrumentation](/docs/specs/otel/glossary/#manual-instrumentation) is
+written by application authors, and typically specific to the application
+domain.
 
 ### Shims
 

content/en/docs/languages/java/libraries.md

@@ -0,0 +1,31 @@
+<!-- prettier-ignore -->
+{{ $howMany := .Get 1 | default 10 -}}
+{{ $langIndex := .Get 0 }}
+{{ $lang := index $.Site.Data.instrumentation $langIndex -}}
+{{ $integrations := where (slice ) ".language" $langIndex -}}
+
+{{ $integrations := slice }} {{ range $entry := $.Site.Data.registry }}
+{{ if and (and (eq $entry.language $langIndex) (eq $entry.isNative true)) (eq $entry.registryType "instrumentation") }}
+{{ $integrations = $integrations | append $entry }} {{ end }} {{ end }}
+
+{{ range first $howMany (sort $integrations "name") -}}
+
+<!-- prettier-ignore -->
+- [{{ .title }}]({{ .urls.docs }})
+{{- end }}
+
+{{ if eq (len $integrations) 0 -}}
+
+<div class="alert alert-secondary" role="alert">
+<h4 class="alert-title">Help wanted!</h4>
+As of today, we don't know about any {{ $lang.name }} library that has OpenTelemetry
+natively integrated. If you know about such a library,
+<a href="https://github.com/open-telemetry/opentelemetry.io/issues/new" target="_blank" rel="noopener" class="external-link">let us know</a>.
+</div>
+{{ else -}}
+<div class="alert alert-info" role="alert">
+If you know a {{ $lang.name }} library that has OpenTelemetry
+natively integrated,
+<a href="https://github.com/open-telemetry/opentelemetry.io/issues/new" target="_blank" rel="noopener" class="external-link">let us know</a>.
+</div>
+{{ end -}}

layouts/partials/docs/native-libraries.md

@@ -31,24 +31,4 @@ OpenTelemetry SDK with your app.
 The library might require some additional configuration for the instrumentation.
 Go to the documentation for that library to learn more.
 
-{{ range first $howMany (sort $integrations "name") -}}
-
-<!-- prettier-ignore -->
-- [{{ .title }}]({{ .urls.docs }})
-{{- end }}
-
-{{ if eq (len $integrations) 0 -}}
-
-<div class="alert alert-secondary" role="alert">
-<h4 class="alert-title">Help wanted!</h4>
-As of today, we don't know about any {{ $lang.name }} library that has OpenTelemetry
-natively integrated. If you know about such a library,
-<a href="https://github.com/open-telemetry/opentelemetry.io/issues/new" target="_blank" rel="noopener" class="external-link">let us know</a>.
-</div>
-{{ else -}}
-<div class="alert alert-info" role="alert">
-If you know a {{ $lang.name }} library that has OpenTelemetry
-natively integrated,
-<a href="https://github.com/open-telemetry/opentelemetry.io/issues/new" target="_blank" rel="noopener" class="external-link">let us know</a>.
-</div>
-{{ end -}}
+{{ partial "docs/native-libraries.md" . }}

layouts/shortcodes/docs/languages/libraries-intro.md

@@ -0,0 +1 @@
+{{ partial "docs/native-libraries.md" . }}