fix the typo in the metadata, clarify the wording, and restore the readme.

Author: mznet

instrumentation/kafka/README.md

@@ -1,9 +1,6 @@
 # Settings for the Kafka instrumentation
 
-| System property                                           | Type    | Default | Description                                                                |
-|-----------------------------------------------------------|---------|---------|----------------------------------------------------------------------------|
-| `otel.instrumentation.kafka.experimental-span-attributes` | Boolean | `false` | Enable the capture of experimental span attributes.                        |
-| `otel.instrumentation.kafka.producer-propagation.enabled` | Boolean | `true`  | Enable context propagation for kafka message producer.                     |
-| `otel.instrumentation.messaging.experimental.capture-headers` | List    | Empty   | Enable the capture of experimental headers in messaging systems.           |
-| `otel.instrumentation.messaging.experimental.receive-telemetry.enabled` | Boolean | `false` | Enable the capture of experimental receive telemetry in messaging systems. |
----------
+| System property                                           | Type    | Default | Description                                                                                                                    |
+|-----------------------------------------------------------| ------- |---------|--------------------------------------------------------------------------------------------------------------------------------|
+| `otel.instrumentation.kafka.experimental-span-attributes` | Boolean | `false` | Enable the capture of experimental span attributes.                                                                            |
+| `otel.instrumentation.kafka.producer-propagation.enabled` | Boolean | `true`  | Enable context propagation for kafka message producer.                                                                         |1

instrumentation/kafka/kafka-clients/kafka-clients-0.11/metadata.yaml

@@ -1,5 +1,5 @@
 description: >
-  This instrumentation provides producer and consumer spans and metrics for Apache Kafka 0.11 clients.
+  This instrumentation provides messaging spans and metrics for Apache Kafka 0.11 clients.
   It automatically traces message production and consumption, propagates context, and emits metrics for production and consumption.
 configurations:
   - name: otel.instrumentation.kafka.producer-propagation.enabled
@@ -11,10 +11,10 @@ configurations:
     type: boolean
     default: false
   - name: otel.instrumentation.messaging.experimental.capture-headers
-    description: Allows configuring headers to capture as span attributes.
+    description: A comma-separated list of header names to capture as span attributes.
     type: list
     default: ''
   - name: otel.instrumentation.messaging.experimental.receive-telemetry.enabled
-    description: Enables experimental receive telemetry for AWS SDK instrumentation.
+    description: Enables experimental receive telemetry for Kafka instrumentation.
     type: boolean
     default: false

instrumentation/kafka/kafka-clients/kafka-clients-2.6/metadata.yaml

@@ -1,2 +1,2 @@
 description: >
-  This instrumentation provides a library integeration that enables producer and consumer spans and metrics for Apache Kafka 2.6+ clients.
+  This instrumentation provides a library integeration that enables messaging spans and metrics for Apache Kafka 2.6+ clients.