From f8576d44b12feb101f6983a18784828b9f16364f Mon Sep 17 00:00:00 2001
From: smoogipooo <smoogipooo@gmail.com>
Date: Tue, 22 Aug 2017 21:08:27 +0900
Subject: [PATCH] Add some more xmldoc.

---
 osu.Game/Rulesets/UI/ScrollingPlayfield.cs | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Rulesets/UI/ScrollingPlayfield.cs b/osu.Game/Rulesets/UI/ScrollingPlayfield.cs
index 7143401824..92845c3f3a 100644
--- a/osu.Game/Rulesets/UI/ScrollingPlayfield.cs
+++ b/osu.Game/Rulesets/UI/ScrollingPlayfield.cs
@@ -173,7 +173,8 @@ namespace osu.Game.Rulesets.UI
             }
 
             /// <summary>
-            /// Adds a <see cref="SpeedAdjustmentContainer"/> to this container.
+            /// Adds a <see cref="SpeedAdjustmentContainer"/> to this container, re-sorting all hit objects
+            /// in the last <see cref="SpeedAdjustmentContainer"/> that occurred (time-wise) before it.
             /// </summary>
             /// <param name="speedAdjustment">The <see cref="SpeedAdjustmentContainer"/>.</param>
             public void AddSpeedAdjustment(SpeedAdjustmentContainer speedAdjustment)
@@ -184,6 +185,8 @@ namespace osu.Game.Rulesets.UI
 
                 if (speedAdjustments.Count > 0)
                 {
+                    // We need to re-sort all hit objects in the speed adjustment container prior to figure out if they
+                    // should now lie within this one
                     var existingAdjustment = adjustmentContainerAt(speedAdjustment.ControlPoint.StartTime);
                     for (int i = 0; i < existingAdjustment.Count; i++)
                     {