Move remarks into summary to make them more visible (#1594)

Author: bording

src/NServiceBus.Transport.RabbitMQ/Configuration/RabbitMQTransportSettingsExtensions.cs

@@ -116,12 +116,11 @@ public static TransportExtensions<RabbitMQTransport> CustomMessageIdStrategy(thi
 
         /// <summary>
         /// Disables the specified broker requirement checks.
+        /// <br />
+        /// Using a broker that does not meet all of the requirements can result in message loss or other incorrect operation, so disabling checks is not recommended.
         /// </summary>
         /// <param name="transportExtensions"></param>
         /// <param name="brokerRequirementChecks">The broker requirement checks to disable.</param>
-        /// <remarks>
-        /// Using a broker that does not meet all of the requirements can result in message loss or other incorrect operation, so disabling checks is not recommended.
-        /// </remarks>
         [PreObsolete("https://github.com/Particular/NServiceBus/issues/6811",
             Message = "This is now part of routing topology configuration, which has been moved to the constructor of the RabbitMQTransport class.",
             Note = "Should not be converted to an ObsoleteEx until API mismatch described in issue is resolved.")]
@@ -165,10 +164,9 @@ public static TransportExtensions<RabbitMQTransport> DisableRemoteCertificateVal
 
         /// <summary>
         /// Specifies that the transport should not validate that queue delivery limits are configured properly to avoid interfering with message recoverability.
-        /// </summary>
-        /// <remarks>
+        /// <br />
         /// Incorrect delivery limit settings could result in message loss, so disabling validation is not recommended.
-        /// </remarks>
+        /// </summary>
         [PreObsolete("https://github.com/Particular/NServiceBus/issues/6811",
             ReplacementTypeOrMember = "RabbitMQTransport.ValidateDeliveryLimits",
             Message = "The configuration has been moved to RabbitMQTransport class.",

src/NServiceBus.Transport.RabbitMQ/RabbitMQTransport.cs

@@ -139,10 +139,9 @@ public PrefetchCountCalculation PrefetchCountCalculation
 
         /// <summary>
         /// Should the transport validate that queue delivery limits are configured properly to avoid interfering with message recoverability.
-        /// </summary>
-        /// <remarks>
+        /// <br />
         /// Incorrect delivery limit settings could result in message loss, so disabling validation is not recommended.
-        /// </remarks>
+        /// </summary>
         public bool ValidateDeliveryLimits { get; set; } = true;
 
         /// <summary>
@@ -152,10 +151,9 @@ public PrefetchCountCalculation PrefetchCountCalculation
 
         /// <summary>
         /// The broker requirement checks to disable.
-        /// </summary>
-        /// <remarks>
+        /// <br />
         /// Using a broker that does not meet all of the requirements can result in message loss or other incorrect operation, so disabling the checks is not recommended.
-        /// </remarks>
+        /// </summary>
         public BrokerRequirementChecks DisabledBrokerRequirementChecks { get; set; }
 
         /// <summary>