Improve docs for BinaryData.ToString() (#22880)

Azure · Jul 26, 2021 · d462477 · d462477
1 parent 3637342
commit d462477
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/sdk/core/System.Memory.Data/src/BinaryData.cs b/sdk/core/System.Memory.Data/src/BinaryData.cs
@@ -202,6 +202,11 @@ public static BinaryData FromObjectAsJson<T>(
         /// <summary>
         /// Converts the value of this instance to a string using UTF-8.
         /// </summary>
+        /// <remarks>
+        /// If the underlying object is a JSON string, calling <see cref="ToString"/> will retain the wrapping double quotes in the
+        /// resulting string. If you want to deserialize the JSON string to a string, thereby removing the wrapping double quotes,
+        /// call <see cref="ToObjectFromJson{String}"/> instead.
+        /// </remarks>
         /// <returns>
         /// A string from the value of this instance, using UTF-8 to decode the bytes.
         /// </returns>