fixup

core/src/main/java/fr/sncf/osrd/conflicts/IncrementalConflictDetector.kt

@@ -47,7 +47,8 @@ fun incrementalConflictDetectorFromReq(
  * trains, and new requirements come from the train we are trying to fit in the timetable.
  */
 class IncrementalConflictDetector(requirements: List<Requirements>) {
-    // Zone name -> (end time -> Range(start time, end time))
+    // Zone name -> (end time -> Range(start time, end time)).
+    // The range is partially redundant, but it makes for easier and clearer processing.
     private val spacingZoneUses: Map<String, TreeMap<Double, Range<Double>>>
 
     init {
@@ -128,6 +129,9 @@ class IncrementalConflictDetector(requirements: List<Requirements>) {
         spacingRequirements: List<SpacingRequirement>,
     ): Double {
         var minDelay = 0.0
+        // We iterate until the requirements fit in the timetable,
+        // shifting them later whenever a conflict is detected.
+        // We stop once we go for a whole loop without conflict.
         while (true) {
             var hasIncreasedDelay = false
             for (spacingRequirement in spacingRequirements) {