Document precedence order is multiple context propagators are used

[malafeev]

fix #1271

[codecov]

Codecov Report

Merging #1698 into master will decrease coverage by 0.03%.
The diff coverage is n/a.

@@             Coverage Diff              @@
##             master    #1698      +/-   ##
============================================
- Coverage     85.51%   85.47%   -0.04%     
  Complexity     1442     1442              
============================================
  Files           177      177              
  Lines          5571     5571              
  Branches        578      578              
============================================
- Hits           4764     4762       -2     
- Misses          606      607       +1     
- Partials        201      202       +1     

Impacted Files	Coverage Δ	Complexity Δ
...context/propagation/DefaultContextPropagators.java	97.05% <ø> (ø)	3.00 <0.00> (ø)
...y/sdk/metrics/aggregator/DoubleMinMaxSumCount.java	95.91% <0.00%> (-4.09%)	6.00% <0.00%> (ø%)

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update def5a23...b29b5a3. Read the comment docs.

[Oberon00]

I think this is currently unspecified in the spec, as open-telemetry/opentelemetry-specification#496 is still open. If so, I think we should leave this unspecified in Java too to be able to follow the spec later without breaking documented behavior.

[jkwatson]

I think this is currently unspecified in the spec, as open-telemetry/opentelemetry-specification#496 is still open. If so, I think we should leave this unspecified in Java too to be able to follow the spec later without breaking documented behavior.

ping @malafeev

[carlosalberto]

I'm tempted to state/document here that the order is undefined for the time being. That way at least we are not tied for now ;) Does that sound right? If YES, @malafeev, you can iterate on this PR ;)

[malafeev]

updated