HttpCorrelationProtocol docs update: Add notice about W3C trace-context and deprecate...

* Update HttpCorrelationProtocol.md

Commit migrated from https://github.com/dotnet/corefx/commit/e23119d577e644d2c2a25419c88c1181681358e0

diff --git a/src/libraries/System.Diagnostics.DiagnosticSource/src/FlatRequestId.md b/src/libraries/System.Diagnostics.DiagnosticSource/src/FlatRequestId.md
index 31683b6..1f8165a 100644 (file)
--- a/src/libraries/System.Diagnostics.DiagnosticSource/src/FlatRequestId.md
+++ b/src/libraries/System.Diagnostics.DiagnosticSource/src/FlatRequestId.md
@@ -1,3 +1,10 @@
+# Note
+Starting with System.Diagnostics.DiagnosticSource 4.6.0 (that ships with .Net Core 3.0), we are moving towards [W3C Trace-Context](https://www.w3.org/TR/trace-context/) standard. We still support Request-Id ([hierarchical](HierarchicalRequestId.md) version) and it is still the default format for `System.Diagnostics.Activity`.
+
+This specification for `Flat Request-Id` is **deprecated**. 
+
+There is no corresponding implementation in .NET and if you are looking into 'flat' correlation protocol - we recommend following [W3C Trace-Context](https://www.w3.org/TR/trace-context/).
+
 # Flat Request-Ids
 This document provide guidance for implementations of [HTTP Correlation Protocol](HttpCorrelationProtocol.md) without [Hierarchical Request-Id](HierarchicalRequestId.md) support or interoperability with services that do not support it. 
 

diff --git a/src/libraries/System.Diagnostics.DiagnosticSource/src/HttpCorrelationProtocol.md b/src/libraries/System.Diagnostics.DiagnosticSource/src/HttpCorrelationProtocol.md
index 498209b..5c2898e 100644 (file)
--- a/src/libraries/System.Diagnostics.DiagnosticSource/src/HttpCorrelationProtocol.md
+++ b/src/libraries/System.Diagnostics.DiagnosticSource/src/HttpCorrelationProtocol.md
@@ -1,4 +1,11 @@
+
+# Note
+Starting with System.Diagnostics.DiagnosticSource 4.6.0 (that ships with .Net Core 3.0), we are moving towards [W3C Trace-Context](https://www.w3.org/TR/trace-context/) standard. We still support Request-Id ([hierarchical](HierarchicalRequestId.md) version) and it is still the default format for `System.Diagnostics.Activity`.
+
+[Flat Request-Id](FlatRequestId.md) is **deprecated**.
+
 # Overview
+    
 One of the common problems in microservices development is ability to trace request flow from client (application, browser) through all the services involved in processing.
 
 Typical scenarios include: