cleanup

src/Sdk/DTWebApi/WebApi/BrokerMigrationMessage.cs

@@ -4,12 +4,15 @@ using System.Runtime.Serialization;
 namespace GitHub.DistributedTask.WebApi
 {
     /// <summary>
-    /// Represents a session for performing message exchanges from an agent.
+    /// Message that tells the runner to redirect itself to BrokerListener for messages.
+    /// (Note that we use a special Message instead of a simple 302. This is because 
+    /// the runner will need to apply the runner's token to the request, and it is
+    /// a security best practice to *not* blindly add sensitive data to redirects
+    /// 302s.)
     /// </summary>
     [DataContract]
     public class BrokerMigrationMessage
     {
-
         public static readonly string MessageType = "BrokerMigration";
 
         public BrokerMigrationMessage()
@@ -23,7 +26,7 @@ namespace GitHub.DistributedTask.WebApi
         }
 
         /// <summary>
-        /// Gets the unique identifier for this session.
+        /// The base url for the broker listener
         /// </summary>
         [DataMember]
         public Uri BrokerBaseUrl