Added a few comments

Author: johnsimons

src/ServiceControl.MultiInstance.AcceptanceTests/Recoverability/WhenRetryingSameMessageMultipleTimes.cs

@@ -34,10 +34,10 @@ await Define<MyContext>()
                     b.When(bus => bus.SendLocal(new MyMessage())).DoNotFailOnErrorMessages())
                 .Done(async c =>
                 {
-                    if (c.RetryCount >= retryTypes.Length)
+                    if (c.RetryCount >= retryTypes.Length) // Are all retries done?
                     {
                         return !(await GetAllFailedMessage(ServiceControlInstanceName, FailedMessageStatus.Unresolved))
-                            .HasResult;
+                            .HasResult; // Should return true if all failed messages are no longer unresolved
                     }
 
                     if (retryTypes[c.RetryCount] == RetryType.Edit)
@@ -46,7 +46,7 @@ await Define<MyContext>()
                             FailedMessageStatus.Unresolved);
                         if (!results.HasResult)
                         {
-                            return false;
+                            return false; // No failed messages yet
                         }
 
                         var result = results.Items.Single();
@@ -57,7 +57,7 @@ await Define<MyContext>()
                     var failedMessage = await GetFailedMessage(c.UniqueMessageId, ServiceControlInstanceName, FailedMessageStatus.Unresolved);
                     if (!failedMessage.HasResult)
                     {
-                        return false;
+                        return false; // No failed message yet
                     }
 
                     if (retryTypes[c.RetryCount] == RetryType.Edit)

src/ServiceControl.MultiInstance.AcceptanceTests/Recoverability/WhenRetryingWithEdit.cs

@@ -30,7 +30,7 @@ await Define<MyContext>()
                         FailedMessageStatus.Unresolved);
                     if (!failedMessage.HasResult)
                     {
-                        return false;
+                        return false; // No failed message yet
                     }
 
                     await this.Post<object>($"/api/edit/{failedMessage.Item.UniqueMessageId}",
@@ -47,7 +47,7 @@ await this.Post<object>($"/api/edit/{failedMessage.Item.UniqueMessageId}",
 
                 var failedResolvedMessage = await GetFailedMessage(c.UniqueMessageId, ServiceControlInstanceName, FailedMessageStatus.Resolved);
 
-                return failedResolvedMessage.HasResult;
+                return failedResolvedMessage.HasResult; // If there is a result it means the message was resolved
             })
             .Run(TimeSpan.FromMinutes(2));
     }