[chore] [exporterhelper] Update notes for the experimental API

exporter/exporterhelper/common.go

@@ -110,7 +110,7 @@ func WithQueue(config QueueSettings) Option {
 
 // WithRequestQueue enables queueing for an exporter.
 // This option should be used with the new exporter helpers New[Traces|Metrics|Logs]RequestExporter.
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 func WithRequestQueue(cfg exporterqueue.Config, queueFactory exporterqueue.Factory[Request]) Option {
 	return func(o *baseExporter) {

exporter/exporterhelper/logs.go

@@ -87,7 +87,7 @@ func NewLogsExporter(
 }
 
 // RequestFromLogsFunc converts plog.Logs data into a user-defined request.
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 type RequestFromLogsFunc func(context.Context, plog.Logs) (Request, error)
 
@@ -99,7 +99,7 @@ func requestFromLogs(pusher consumer.ConsumeLogsFunc) RequestFromLogsFunc {
 }
 
 // NewLogsRequestExporter creates new logs exporter based on custom LogsConverter and RequestSender.
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 func NewLogsRequestExporter(
 	_ context.Context,

exporter/exporterhelper/metrics.go

@@ -87,7 +87,7 @@ func NewMetricsExporter(
 }
 
 // RequestFromMetricsFunc converts pdata.Metrics into a user-defined request.
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 type RequestFromMetricsFunc func(context.Context, pmetric.Metrics) (Request, error)
 
@@ -99,7 +99,7 @@ func requestFromMetrics(pusher consumer.ConsumeMetricsFunc) RequestFromMetricsFu
 }
 
 // NewMetricsRequestExporter creates a new metrics exporter based on a custom MetricsConverter and RequestSender.
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 func NewMetricsRequestExporter(
 	_ context.Context,

exporter/exporterhelper/request.go

@@ -8,7 +8,7 @@ import (
 )
 
 // Request represents a single request that can be sent to an external endpoint.
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 type Request interface {
 	// Export exports the request to an external endpoint.
@@ -23,7 +23,7 @@ type Request interface {
 // temporary failures. For example, if some items failed to process and can be retried, this interface allows to
 // return a new Request that contains the items left to be sent. Otherwise, the original Request should be returned.
 // If not implemented, the original Request will be returned assuming the error is applied to the whole Request.
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 type RequestErrorHandler interface {
 	Request

exporter/exporterhelper/traces.go

@@ -87,7 +87,7 @@ func NewTracesExporter(
 }
 
 // RequestFromTracesFunc converts ptrace.Traces into a user-defined Request.
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 type RequestFromTracesFunc func(context.Context, ptrace.Traces) (Request, error)
 
@@ -99,7 +99,7 @@ func requestFromTraces(pusher consumer.ConsumeTracesFunc) RequestFromTracesFunc
 }
 
 // NewTracesRequestExporter creates a new traces exporter based on a custom TracesConverter and RequestSender.
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 func NewTracesRequestExporter(
 	_ context.Context,

exporter/exporterqueue/config.go

@@ -11,7 +11,7 @@ import (
 
 // Config defines configuration for queueing requests before exporting.
 // It's supposed to be used with the new exporter helpers New[Traces|Metrics|Logs]RequestExporter.
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 type Config struct {
 	// Enabled indicates whether to not enqueue batches before exporting.
@@ -23,7 +23,7 @@ type Config struct {
 }
 
 // NewDefaultConfig returns the default Config.
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 func NewDefaultConfig() Config {
 	return Config{
@@ -51,7 +51,7 @@ func (qCfg *Config) Validate() error {
 // The struct is provided to be added in the exporter configuration as one struct under the "sending_queue" key.
 // The exporter helper Go interface requires the fields to be provided separately to WithRequestQueue and
 // NewPersistentQueueFactory.
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 type PersistentQueueConfig struct {
 	Config `mapstructure:",squash"`

exporter/exporterqueue/queue.go

@@ -13,7 +13,7 @@ import (
 
 // Queue defines a producer-consumer exchange which can be backed by e.g. the memory-based ring buffer queue
 // (boundedMemoryQueue) or via a disk-based queue (persistentQueue)
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 type Queue[T any] queue.Queue[T]
 
@@ -24,22 +24,22 @@ type Settings struct {
 }
 
 // Marshaler is a function that can marshal a request into bytes.
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 type Marshaler[T any] func(T) ([]byte, error)
 
 // Unmarshaler is a function that can unmarshal bytes into a request.
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 type Unmarshaler[T any] func([]byte) (T, error)
 
 // Factory is a function that creates a new queue.
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 type Factory[T any] func(context.Context, Settings, Config) Queue[T]
 
 // NewMemoryQueueFactory returns a factory to create a new memory queue.
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 func NewMemoryQueueFactory[T itemsCounter]() Factory[T] {
 	return func(_ context.Context, _ Settings, cfg Config) Queue[T] {
@@ -51,7 +51,7 @@ func NewMemoryQueueFactory[T itemsCounter]() Factory[T] {
 }
 
 // PersistentQueueSettings defines developer settings for the persistent queue factory.
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 type PersistentQueueSettings[T any] struct {
 	// Marshaler is used to serialize queue elements before storing them in the persistent storage.
@@ -62,7 +62,7 @@ type PersistentQueueSettings[T any] struct {
 
 // NewPersistentQueueFactory returns a factory to create a new persistent queue.
 // If cfg.StorageID is nil then it falls back to memory queue.
-// This API is at the early stage of development and may change without backward compatibility
+// Experimental: This API is at the early stage of development and may change without backward compatibility
 // until https://github.com/open-telemetry/opentelemetry-collector/issues/8122 is resolved.
 func NewPersistentQueueFactory[T itemsCounter](storageID *component.ID, factorySettings PersistentQueueSettings[T]) Factory[T] {
 	if storageID == nil {