7610-MicroProfile 7.0 ID-5

7610-MicroProfile 7.0 ID-5

#7610

modules/reference/pages/diff/mp-61-70-diff.adoc

@@ -28,15 +28,15 @@ This release includes several significant changes.
 
 If you are updating your application from using MicroProfile 6.1 features to using link:https://github.com/eclipse/microprofile/releases/tag/7.0[MicroProfile 7.0] features, the changes in API behavior might require you to update your application code. The following sections provide details about migrating your applications from MicroProfile 6.1 to MicroProfile 7.0:
 
-- <<#mp, MicroProfile 7.0 vs. MicroProfile 6.1>>
+- <<#mp, Differences between MicroProfile 7.0 and 6.1>>
 - <<#rc, Differences between MicroProfile REST Client 4.0 and 3.0>>
-- <<#openapi, Differences between MicroProfile OpenAPI 3.1 and 4.0>>
-- <<#ft, Fault Tolerance Version Updated to 4.1>>
-- <<#tm, Telemetry Version Updated to 2.0>>
+- <<#openapi, Differences between MicroProfile OpenAPI 4.0 and 3.1>>
+- <<#ft, Differences between Fault Tolerance 4.1 and 4.0>>
+- <<#tm, Differences between Telemetry 2.0 and 1.1>>
 
 
 [#mp]
-== MicroProfile 7.0 vs. MicroProfile 6.1
+== Differences between MicroProfile 7.0 and 6.1
 
 link:https://download.eclipse.org/microprofile/microprofile-7.0/microprofile-spec-7.0.html[MicroProfile 7.0] is a major release that includes backward-incompatible changes. One significant update is the replacement of MicroProfile Metrics with MicroProfile Telemetry 2.0, which offers Metrics capabilities in addition to support for logs and tracing.
 
@@ -91,9 +91,9 @@ Information and example code are added to the link:https://download.eclipse.org/
 
 
 [#openapi]
-== Differences between MicroProfile OpenAPI 3.1 and 4.0
+== Differences between MicroProfile OpenAPI 4.0 and 3.1
 
-=== OpenAPI Version Updated to 3.1
+=== OpenAPI version updated to 3.1
 
 The OpenAPI document is now generated in OpenAPI 3.1 format by default, an update from OpenAPI 3.0 in `mpOpenAPI-3.1`.
 
@@ -128,7 +128,7 @@ For more information on this configuration, see feature:mpOpenAPI-4.0[display=Mi
 
 
 [#ft]
-== Fault Tolerance Version Updated to 4.1
+== Differences between Fault Tolerance 4.1 and 4.0
 
 MicroProfile Fault Tolerance 4.1, an update to version 4.0, introduces integration with MicroProfile Telemetry 2.0. This allows Fault Tolerance to export metrics directly to MicroProfile Telemetry. The existing integration with `mpMetrics` remains unchanged.
 
@@ -227,7 +227,7 @@ If `mpFaultTolerance-4.1` is enabled alongside both `mpTelemetry-2.0` and `mpMet
 
 
 [#tm]
-== Telemetry Version Updated to 2.0
+== Differences between MicroProfile Telemetry 2.0 and 1.1
 
 MicroProfile Telemetry 2.0 is an update to MicroProfile Telemetry 1.1, incorporating the latest OpenTelemetry SDK (version 1.39). Previously, only traces were collected and exported. The updated feature now includes the ability to collect and export metrics and logs. Specifically, the following enhancements are provided:
 
@@ -279,7 +279,7 @@ To make the APIs accessible, you must enable third-party APIs for your applicati
 </webApplication>
 ----
 
-=== Collecting Logs
+=== Collecting logs
 
 You can enable MicroProfile Telemetry to collect logs from various sources within the Open Liberty runtime environment. MicroProfile Telemetry can collect the following types of events:
 
@@ -296,7 +296,7 @@ To enable these log sources, configure the source attribute for the mpTelemetry
 
 The mpTelemetry configuration element is optional. If you do not specify it or omit the source attribute, the default configuration source is message. For more details, see feature:mpTelemetry-2.0[display=Collect logs from a specified source].
 
-=== Exporting Metrics and Logs
+=== Exporting metrics and logs
 
 By default, all OpenTelemetry data is exported to link:https://opentelemetry.io/docs/specs/otel/protocol/exporter/[OTLP]. You can change the export settings for metrics by specifying the `otel.metrics.exporter` property or the `OTEL_METRICS_EXPORTER` environment variable. For logs, specify the `otel.logs.exporter` property or the `OTEL_LOGS_EXPORTER` environment variable.