tidy up documentation around ChannelMessageQueue

StackExchange.Redis/StackExchange/Redis/ChannelMessageQueue.cs

@@ -30,6 +30,7 @@ internal ChannelMessage(RedisChannel channel, RedisValue value)
     /// <summary>
     /// Represents a message queue of pub/sub notifications
     /// </summary>
+    /// <remarks>To create a ChannelMessageQueue, use ISubscriber.Subscribe[Async](RedisKey)</remarks>
     public sealed class ChannelMessageQueue
     {
         private readonly Channel<ChannelMessage> _channel;

StackExchange.Redis/StackExchange/Redis/ConfigurationOptions.cs

@@ -258,7 +258,7 @@ public int ConnectTimeout
         /// <summary>
         /// Specifies whether asynchronous operations should be invoked in a way that guarantees their original delivery order
         /// </summary>
-        [Obsolete("Not supported; attempting to guarantee delivery order is consistently a cause of major performance problems", false)]
+        [Obsolete("Not supported; if you require ordered pub/sub, please see " + nameof(ChannelMessageQueue), false)]
         public bool PreserveAsyncOrder
         {
             get { return preserveAsyncOrder.GetValueOrDefault(true); }

StackExchange.Redis/StackExchange/Redis/ConnectionMultiplexer.cs

@@ -1809,7 +1809,7 @@ public override string ToString()
         /// <summary>
         /// Gets or sets whether asynchronous operations should be invoked in a way that guarantees their original delivery order
         /// </summary>
-        [Obsolete("Not supported; attempting to guarantee delivery order is consistently a cause of major performance problems", false)]
+        [Obsolete("Not supported; if you require ordered pub/sub, please see " + nameof(ChannelMessageQueue), false)]
         public bool PreserveAsyncOrder
         {
             get => false;

StackExchange.Redis/StackExchange/Redis/Interfaces/IConnectionMultiplexer.cs

@@ -44,7 +44,7 @@ public interface IConnectionMultiplexer
         /// <summary>
         /// Gets or sets whether asynchronous operations should be invoked in a way that guarantees their original delivery order
         /// </summary>
-        [Obsolete("Not supported; attempting to guarantee delivery order is consistently a cause of major performance problems", false)]
+        [Obsolete("Not supported; if you require ordered pub/sub, please see " + nameof(ChannelMessageQueue), false)]
         bool PreserveAsyncOrder { get; set; }
 
         /// <summary>