From 3670a697220877b2d511d3e2e1920c749e9f83ee Mon Sep 17 00:00:00 2001
From: Sergei Malafeev <sergei@malafeev.org>
Date: Wed, 21 Oct 2020 05:07:00 +0800
Subject: [PATCH] Document precedence order is multiple context propagators are
 used (#1698)

* Document precedence order is multiple context propagators are used

Signed-off-by: Sergei Malafeev <sergei@malafeev.org>

* implement review comments

Signed-off-by: Sergei Malafeev <sergei@malafeev.org>
---
 .../context/propagation/DefaultContextPropagators.java         | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/context_prop/src/main/java/io/opentelemetry/context/propagation/DefaultContextPropagators.java b/context_prop/src/main/java/io/opentelemetry/context/propagation/DefaultContextPropagators.java
index 41af84a5b7..910fb0d219 100644
--- a/context_prop/src/main/java/io/opentelemetry/context/propagation/DefaultContextPropagators.java
+++ b/context_prop/src/main/java/io/opentelemetry/context/propagation/DefaultContextPropagators.java
@@ -48,6 +48,9 @@ public final class DefaultContextPropagators implements ContextPropagators {
    * {@link Builder} is used to construct a new {@code ContextPropagators} object with the specified
    * propagators.
    *
+   * <p>Invocation order of {@code TextMapPropagator#inject()} and {@code
+   * TextMapPropagator#extract()} for registered trace propagators is undefined.
+   *
    * <p>This is a example of a {@code ContextPropagators} object being created:
    *
    * <pre>{@code