[IA] Rename /docs/instrumentation to /docs/languages, and Manual subpages to Instrumentation (#3761)

Author: svrnm

.htmltest.yml

@@ -9,8 +9,8 @@ IgnoreDirs:
   - ^blog/(\d+/)?page/\d+
 IgnoreInternalURLs: # list of paths
 IgnoreURLs: # list of regexs of paths or URLs to be ignored
-  - ^/docs/instrumentation/\w+/(api|examples)/$
-  - ^/docs/instrumentation/net/(metrics-api|traces-api)/
+  - ^/docs/languages/\w+/(api|examples)/$
+  - ^/docs/languages/net/(metrics-api|traces-api)/
   - ^/community/end-user/feedback-survey/$
   - ^(/docs/migration/)?opencensus/$
 

content/en/_index.md

@@ -47,7 +47,7 @@ generate, collect, and export telemetry data (metrics, logs, and traces) to help
 you analyze your software's performance and behavior.
 
 > OpenTelemetry is **generally available** across
-> [several languages](/docs/instrumentation/) and is suitable for use.
+> [several languages](/docs/languages/) and is suitable for use.
 
 {{% /blocks/lead %}}
 

content/en/blog/2022/debug-otel-with-otel/index.md

@@ -261,5 +261,5 @@ COPY opentelemetry_module.conf /etc/nginx/conf.d
 [v1.0.1 release of the otel-webserver-module]:
   https://github.com/open-telemetry/opentelemetry-cpp-contrib/releases/tag/webserver%2Fv1.0.1
 [java]:
-  /docs/instrumentation/java/automatic/agent-config/#capturing-http-request-and-response-headers
-[python]: /docs/instrumentation/python/automatic/
+  /docs/languages/java/automatic/agent-config/#capturing-http-request-and-response-headers
+[python]: /docs/languages/python/automatic/

content/en/blog/2022/exponential-histograms/index.md

@@ -302,5 +302,5 @@ _A version of this article was [originally posted][] on the New Relic blog._
 [otlp]: /docs/specs/otlp/
 [opentelemetry-java]: https://github.com/open-telemetry/opentelemetry-java
 [environment variable]: /docs/specs/otel/metrics/sdk_exporters/otlp/
-[instrumentation]: /docs/instrumentation
+[instrumentation]: /docs/languages
 [github.com/open-telemetry]: https://github.com/open-telemetry

content/en/blog/2022/frontend-overhaul/index.md

@@ -54,15 +54,15 @@ context.
 The demo’s stack includes multiple microservices in different languages,
 covering each of the following OTel-supported languages:
 
-- [C++](/docs/instrumentation/cpp/)
-- [.NET](/docs/instrumentation/net/)
-- [Erlang/Elixir](/docs/instrumentation/erlang/)
-- [Go](/docs/instrumentation/go/)
-- [Node.js](/docs/instrumentation/js/)
-- [PHP](/docs/instrumentation/php/)
-- [Python](/docs/instrumentation/python/)
-- [Ruby](/docs/instrumentation/ruby/)
-- [Rust](/docs/instrumentation/rust/)
+- [C++](/docs/languages/cpp/)
+- [.NET](/docs/languages/net/)
+- [Erlang/Elixir](/docs/languages/erlang/)
+- [Go](/docs/languages/go/)
+- [Node.js](/docs/languages/js/)
+- [PHP](/docs/languages/php/)
+- [Python](/docs/languages/python/)
+- [Ruby](/docs/languages/ruby/)
+- [Rust](/docs/languages/rust/)
 
 Every microservice has a specific goal and can communicate with others by using
 a global gRPC definition. Persistent information is saved into a PostgreSQL

content/en/blog/2023/end-user-discussions-01.md

@@ -159,7 +159,7 @@ find a channel for your language, feel free to start a discussion on the
 [OpenTelemetry CNCF Slack channel](https://cloud-native.slack.com/archives/CJFCJHG4Q),
 or on [GitHub](https://github.com/open-telemetry/community), like with
 [this issue for OTel for Perl](https://github.com/open-telemetry/community/issues/828).
-Please also check out [this page](/docs/instrumentation/other/) for more info.
+Please also check out [this page](/docs/languages/other/) for more info.
 
 #### 2- Python instrumentation
 

content/en/blog/2023/end-user-discussions-03.md

@@ -190,9 +190,9 @@ agent to the host metrics receiver for infrastructure monitoring.
   maturing in OTel; for example, the Java JAR agent takes care of instrumenting
   [most libraries](https://github.com/open-telemetry/opentelemetry-java-instrumentation/blob/main/docs/supported-libraries.md#libraries--frameworks)
   that are used by applications. Auto-instrumentation is also available for
-  [Python](/docs/instrumentation/python/automatic/),
-  [.NET](/docs/instrumentation/net/automatic/), and
-  [Node.js](/docs/instrumentation/js/automatic).
+  [Python](/docs/languages/python/automatic/),
+  [.NET](/docs/languages/net/automatic/), and
+  [Node.js](/docs/languages/js/automatic).
 - If you’re using Kubernetes, they can use the
   [OTel operator](https://github.com/open-telemetry/opentelemetry-operator),
   which takes care of instrumentations for applications deployed on K8s. The

content/en/blog/2023/end-user-q-and-a-01.md

@@ -118,8 +118,7 @@ analysis.
 ### How do you generate traces?
 
 To instrument their code, they configure the
-[Node.js SDK](/docs/instrumentation/js/getting-started/nodejs/) and use a number
-of
+[Node.js SDK](/docs/languages/js/getting-started/nodejs/) and use a number of
 [Node.js auto-instrumentation plug-ins](https://github.com/open-telemetry/opentelemetry-js-contrib/tree/main/plugins/node).
 While the team is currently only using
 [auto-instrumentation](/docs/specs/otel/glossary/#automatic-instrumentation) to

content/en/blog/2023/end-user-q-and-a-02.md

@@ -135,9 +135,9 @@ experience OpenTelemetry in action:
 - Seeing structured logs, being able to correlate traces and logs, and emitting
   metrics.
 - Experiencing the benefits of
-  [context propagation](/docs/instrumentation/js/propagation/) – i.e. spans and
-  traces interacting across different operations to provide an end-to-end view
-  of a service call.
+  [context propagation](/docs/languages/js/propagation/) – i.e. spans and traces
+  interacting across different operations to provide an end-to-end view of a
+  service call.
 
 ### How did you promote OpenTelemetry across the organization?
 

content/en/blog/2023/logs-collection/index.md

@@ -473,7 +473,7 @@ check out the following resources:
 [otel-logs-events]: /docs/specs/otel/logs/event-api/
 [otel-semconv-logs]: /docs/specs/semconv/general/logs/
 [otel-python-repo]: https://github.com/open-telemetry/opentelemetry-python
-[otel-python]: /docs/instrumentation/python/
+[otel-python]: /docs/languages/python/
 [py-docs-logs]:
   https://opentelemetry-python-contrib.readthedocs.io/en/latest/instrumentation/logging/logging.html
 [py-docs-logs-example]:

content/en/blog/2023/otel-dotnet-auto-instrumentation.md

@@ -20,7 +20,7 @@ package that simplify the task of deploying and configuring the collection of
 telemetry. The automatic instrumentation is fully compatible with manual
 instrumentation in case you need to send custom spans or metrics.
 
-To get started, [read the documentation](/docs/instrumentation/net/automatic) or
+To get started, [read the documentation](/docs/languages/net/automatic) or
 browse the
 [examples](https://github.com/open-telemetry/opentelemetry-dotnet-instrumentation/tree/main/examples)
 for demonstrations of different instrumentation scenarios covered by the

content/en/blog/2023/otel-go-metrics-sdk-stable.md

@@ -12,6 +12,5 @@ of OpenTelemetry Go. Project stability guarantees now apply to the
 [go.opentelemetry.io/otel/sdk/metric](https://pkg.go.dev/go.opentelemetry.io/otel/sdk/metric)
 module.
 
-To learn more check the
-[getting started](/docs/instrumentation/go/getting-started) and
-[manual metrics](/docs/instrumentation/go/manual#metrics) documentation.
+To learn more check the [getting started](/docs/languages/go/getting-started)
+and [manual metrics](/docs/languages/go/instrumentation#metrics) documentation.

content/en/blog/2023/otel-in-focus-02.md

@@ -44,15 +44,15 @@ have been released with several major changes to be aware of:
   for more information.
 - Many bugfixes and enhancements.
 
-##### [Go](/docs/instrumentation/go/)
+##### [Go](/docs/languages/go/)
 
 [v1.14](https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.14.0)
 has been released. This is the last release to support Go 1.18; 1.19 will be
 required in the future. Semantic conventions have been updated, resulting in
 changes to constant and function names. Finally, there’s a variety of bug fixes
 and other small changes.
 
-##### [Java](/docs/instrumentation/java/)
+##### [Java](/docs/languages/java/)
 
 [v1.23](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.23.0)
 has been released, bringing with it stable base2 exponential histogram
@@ -63,20 +63,20 @@ also in this release.
 has been updated as well, most notably changing HTTP span names to reflect
 updated semantic conventions.
 
-##### [PHP](/docs/instrumentation/php/)
+##### [PHP](/docs/languages/php/)
 
 [v1 beta](https://github.com/open-telemetry/opentelemetry-php/releases/tag/1.0.0beta1)
 was [announced](/blog/2023/php-beta-release/) at the end of January. The PHP SIG
 is looking forward to your feedback. In addition, the Communications SIG is
 planning a release of new documentation for PHP soon.
 
-##### [Python](/docs/instrumentation/python/)
+##### [Python](/docs/languages/python/)
 
 [v1.16](https://github.com/open-telemetry/opentelemetry-python/releases/tag/v1.16.0)
 has been released with deprecations to Jaeger exporters, several performance
 improvements and bugfixes, and changes to Prometheus export.
 
-##### [.NET](/docs/instrumentation/net/)
+##### [.NET](/docs/languages/net/)
 
 [v1.4](https://github.com/open-telemetry/opentelemetry-dotnet/releases/tag/core-1.4.0)
 removes several deprecated extension methods.

content/en/blog/2023/otel-in-focus-03.md

@@ -46,7 +46,7 @@ version as well. Highlights include:
 - A new receiver for CloudFlare logs has been added.
 - Many bugfixes and enhancements.
 
-##### [Go](/docs/instrumentation/go/)
+##### [Go](/docs/languages/go/)
 
 [Version v1.15.0-rc.2](https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.15.0-rc.2)
 has been released. Version 1.15 will ship with Metrics v1 support, and its
@@ -57,7 +57,7 @@ include:
 - Exemplar support added for metric data.
 - Several optimizations, bugfixes, and removals/deprecations.
 
-##### [Java](/docs/instrumentation/java/)
+##### [Java](/docs/languages/java/)
 
 [Version 1.24.0](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.24.0)
 of the Java SDK has been released, featuring several optimizations and bugfixes
@@ -74,7 +74,7 @@ and fixes:
 - Improvements to the RxJava2, Cassandra, Spring Boot, and other instrumentation
   packages.
 
-##### [Python](/docs/instrumentation/python/)
+##### [Python](/docs/languages/python/)
 
 [Version 1.17](https://github.com/open-telemetry/opentelemetry-python/releases/tag/v1.17.0)
 has been released with a handful of fixes and improvements, most notably support

content/en/blog/2023/otel-in-focus-04.md

@@ -53,14 +53,14 @@ has been updated to v0.75.0, adding support for feature gates in the operator.
 This release includes several bugfixes and improvements to connectors, along
 with a breaking change to the `confmap` component.
 
-##### [Go](/docs/instrumentation/go/)
+##### [Go](/docs/languages/go/)
 
 [Version v1.15.0](https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.15.0)
 has been released! This marks the official release of OpenTelemetry Metrics v1
 in Go. Please check out the full release notes, as there are several important
 changes and renamings, especially if you're using metrics.
 
-##### [Java](/docs/instrumentation/java/)
+##### [Java](/docs/languages/java/)
 
 [Version 1.25.0](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.25.0)
 of the Java SDK has been released, with several bugfixes and improvements.

content/en/blog/2023/otel-in-focus-05.md

@@ -48,12 +48,12 @@ has been updated with several changes and enhancements. The
 now supports Golang & Apache HTTP server auto-instrumentation in addition to
 Python, Java, Node.js, and .NET.
 
-##### [Go](/docs/instrumentation/go/)
+##### [Go](/docs/languages/go/)
 
 [Version 1.16.0/0.39.0](https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.16.0)
 marks the stable release of the OpenTelemetry Metric API in Go.
 
-##### [Java](/docs/instrumentation/java/)
+##### [Java](/docs/languages/java/)
 
 [Version 1.26](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.26.0)
 is the Release Candidate for the Log Bridge. This release enables log appenders
@@ -66,13 +66,13 @@ improvements.
 includes instrumentation support for vertx-sql-client, as well as several bug
 fixes.
 
-#### [JavaScript](/docs/instrumentation/js/)
+#### [JavaScript](/docs/languages/js/)
 
 [Version 1.13](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v1.13.0)
 has been released, adding support for gRPC log export. In addition, a couple
 bugs have been fixed.
 
-#### [Python](/docs/instrumentation/python/)
+#### [Python](/docs/languages/python/)
 
 [Version 1.18](https://github.com/open-telemetry/opentelemetry-python/releases/tag/v1.18.0)
 adds a new feature that allows histogram aggregation to be set using an
@@ -86,7 +86,7 @@ exporting, and suppressing instrumentation.
   `opentelemetry.sdk.metrics.view`
 - Fix headers types mismatch for OTLP Exporters
 
-#### [.NET](/docs/instrumentation/net/)
+#### [.NET](/docs/languages/net/)
 
 [Version 1.5.0-rc1](https://github.com/open-telemetry/opentelemetry-dotnet/releases/tag/core-1.5.0-rc.1)
 includes many bugfixes across a variety of packages.

content/en/blog/2023/otel-in-focus-06.md

@@ -80,7 +80,7 @@ go auto-instrumentation version correctly. Components that were updated include
 the OpenTelemetry Collector, OpenTelemetry Contrib, Java auto-instrumentation,
 .NET auto-instrumentation, Node.js, Python, Go, and Apache HTTP Server.
 
-##### [Java](/docs/instrumentation/java/)
+##### [Java](/docs/languages/java/)
 
 [Version 1.27](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.27.0)
 has made the Log Bridge API and SDK stable. Important changes include merging
@@ -109,12 +109,12 @@ has been released, requiring some migrations to be performed.
 - Bugfixes related to Logback MDC instrumentation, Kafka metrics reporter, Jetty
   context leak, filtering scalar Mono/Flux instances, and others.
 
-#### [JavaScript](/docs/instrumentation/js/)
+#### [JavaScript](/docs/languages/js/)
 
 [Version 1.14](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v1.14.0)
 includes an optional `forceFlush` method to the `SpanExporter` interface.
 
-#### [.NET](/docs/instrumentation/net/)
+#### [.NET](/docs/languages/net/)
 
 [Version 1.5.1](https://github.com/open-telemetry/opentelemetry-dotnet/releases/tag/core-1.5.1)
 has been released, as well as 1.5.0. 1.5.1 is a fix for issues introduced in

content/en/blog/2023/otel-in-focus-07.md

@@ -52,7 +52,7 @@ now use opaque strings for configuration. This may require changes to your
 collector configuration. New connectors and exporters have been added as well,
 such as the `exceptionsconnector` and `opensearchexporter`.
 
-##### [Java](/docs/instrumentation/java/)
+##### [Java](/docs/languages/java/)
 
 [Version 1.28](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.28.0)
 includes a variety of updates and bug fixes.
@@ -61,18 +61,18 @@ includes a variety of updates and bug fixes.
 has also been released, with some required migrations due to semantic convention
 updates.
 
-#### [Python](/docs/instrumentation/python/)
+#### [Python](/docs/languages/python/)
 
 [Version 1.19](https://github.com/open-telemetry/opentelemetry-python/releases/tag/v1.19.0)
 includes updates to OTLP and log support.
 
-#### [JavaScript](/docs/instrumentation/js/)
+#### [JavaScript](/docs/languages/js/)
 
 [Version 1.15.1](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v1.15.1)
 includes metric bug fixes for histograms and exponential histograms. In
 addition, OTLP support has been updated.
 
-#### [.NET](/docs/instrumentation/net/)
+#### [.NET](/docs/languages/net/)
 
 [Version 1.6.0-alpha.1](https://github.com/open-telemetry/opentelemetry-dotnet/releases/tag/core-1.6.0-alpha.1)
 has been released. 1.6 re-introduces support for exemplars, as well as

content/en/blog/2023/otel-in-focus-08.md

@@ -62,7 +62,7 @@ There are several user-facing changes, including breaking changes:
 - The `receiver/azuremonitor` has added new attributes to metrics like name,
   type, and resource_group.
 
-##### [Java](/docs/instrumentation/java/)
+##### [Java](/docs/languages/java/)
 
 [Version 1.29](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.29.0)
 includes updates to the API and SDK for tracing and metrics. Please note that
@@ -71,25 +71,25 @@ the `zpages` extension has been removed.
 [Java Instrumentation](https://github.com/open-telemetry/opentelemetry-java-instrumentation/releases/tag/v1.29.0)
 includes support for Ktor and ElasticSearch Rest Client.
 
-#### [Python](/docs/instrumentation/python/)
+#### [Python](/docs/languages/python/)
 
 [Version 1.20](https://github.com/open-telemetry/opentelemetry-python/releases/tag/v1.20.0)
 modifies the Prometheus exporter to translate non-monotonic Sums into Gauges.
 
-#### [Go](/docs/instrumentation/go/)
+#### [Go](/docs/languages/go/)
 
 [Version 1.17.0](https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.17.0)
 includes updates to the API and SDK. Highlights include adding support for
 exponential histogram aggregations, support for Semantic Conventions 1.21, and
 bug fixes. Please note that the Jaeger exporter has been deprecated in favor of
 the OTLP exporter.
 
-#### [JavaScript](/docs/instrumentation/js/)
+#### [JavaScript](/docs/languages/js/)
 
 [Version 1.15.2](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v1.15.1)
 fixes several bugs.
 
-#### [.NET](/docs/instrumentation/net/)
+#### [.NET](/docs/languages/net/)
 
 [Version 1.6.0-rc.1](https://github.com/open-telemetry/opentelemetry-dotnet/releases/tag/core-1.6.0-rc.1)
 has been released, bringing small changes to metrics, export, and an

content/en/blog/2023/otel-in-focus-09.md

@@ -115,7 +115,7 @@ This release includes breaking changes from v0.84.0 as well:
   collector defaults.
 - ServiceMonitors are created when Prometheus exporters are used.
 
-##### [Java](/docs/instrumentation/java/)
+##### [Java](/docs/languages/java/)
 
 [Version 1.30](https://github.com/open-telemetry/opentelemetry-java/releases/tag/v1.30.1)
 includes many updates to incubating APIs and SDKs. In the API incubator, an
@@ -150,7 +150,7 @@ with `getDefinedPackage` lookup for OpenJ9, serializing key with Lettuce
 instrumentation, and auto-instrumentation with JMX not working without a
 trigger.
 
-#### [Go](/docs/instrumentation/go/)
+#### [Go](/docs/languages/go/)
 
 [Version 1.19.0](https://github.com/open-telemetry/opentelemetry-go/releases/tag/v1.19.0)
 is the first stable release of Metrics and the standard project stability
@@ -180,15 +180,15 @@ Please note that v1.18.0 included several deprecations and removals:
   now.
 - Go compatibility before version 1.20 is no longer guaranteed.
 
-#### [JavaScript](/docs/instrumentation/js/)
+#### [JavaScript](/docs/languages/js/)
 
 [Version 1.17.0](https://github.com/open-telemetry/opentelemetry-js/releases/tag/v1.17.0)
 fixes an unintentional breaking change in previous releases.
 
 There have been several important changes in the experimental packages,
 including deprecation of legacy configuration APIs.
 
-#### [.NET](/docs/instrumentation/net/)
+#### [.NET](/docs/languages/net/)
 
 [Version 1.6.0](https://github.com/open-telemetry/opentelemetry-dotnet/releases/tag/core-1.6.0)
 includes minor updates to metrics.