Forwarded Header Transforms Doc Comments (#2530)

* Add contextual doc commnets indicating that using Forwarded or XForwarded header transforms will remove the other when enabled.

* Tweak comments

---------

Co-authored-by: Miha Zupan <[email protected]>

src/ReverseProxy/Transforms/ForwardedTransformExtensions.cs

@@ -113,6 +113,9 @@ public static TransformBuilderContext AddXForwardedPrefix(this TransformBuilderC
     /// <summary>
     /// Adds the transform which will add X-Forwarded-* request headers.
     /// </summary>
+    /// <remarks>
+    /// Also removes the <c>Forwarded</c> header when enabled.
+    /// </remarks>
     public static TransformBuilderContext AddXForwarded(this TransformBuilderContext context, ForwardedTransformActions action = ForwardedTransformActions.Set)
     {
         context.AddXForwardedFor(action: action);
@@ -173,6 +176,9 @@ public static RouteConfig WithTransformForwarded(this RouteConfig route, bool us
     /// <summary>
     /// Adds the transform which will add the Forwarded header as defined by [RFC 7239](https://tools.ietf.org/html/rfc7239).
     /// </summary>
+    /// <remarks>
+    /// Also removes the <c>X-Forwarded</c> headers when enabled.
+    /// </remarks>
     public static TransformBuilderContext AddForwarded(this TransformBuilderContext context,
         bool useHost = true, bool useProto = true, NodeFormat forFormat = NodeFormat.Random,
         NodeFormat byFormat = NodeFormat.Random, ForwardedTransformActions action = ForwardedTransformActions.Set)