From 11bc6f9062eac1e9462670eeaddedf461ceda493 Mon Sep 17 00:00:00 2001
From: Fred <zepfred@gmail.com>
Date: Wed, 19 Aug 2026 16:28:33 -0300
Subject: [PATCH 1/2] docs: mention the default moves

---
 .../optimization-algorithms/move-selector-reference.adoc   | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/docs/src/modules/ROOT/pages/optimization-algorithms/move-selector-reference.adoc b/docs/src/modules/ROOT/pages/optimization-algorithms/move-selector-reference.adoc
index 04f97bff4b..ee8b614f62 100644
--- a/docs/src/modules/ROOT/pages/optimization-algorithms/move-selector-reference.adoc
+++ b/docs/src/modules/ROOT/pages/optimization-algorithms/move-selector-reference.adoc
@@ -1081,6 +1081,9 @@ only set the distribution type (so without a `distributionSizeMaximum` parameter
 
 These moves are applicable to planning variables that aren’t part of a list,
 also called xref:domain-modeling/modeling-planning-problems.adoc#planningVariable[basic variables].
+By default, the solver uses the following move selectors:
+xref:optimization-algorithms/move-selector-reference.adoc#changeMoveSelector[Change],
+xref:optimization-algorithms/move-selector-reference.adoc#swapMoveSelector[Swap].
 
 [#changeMoveSelector]
 === `ChangeMoveSelector`
@@ -1490,6 +1493,10 @@ public class MyStageProvider implements BasicVariableStageProvider<Schedule, Shi
 == Move selectors for list variables
 
 These moves are applicable to xref:domain-modeling/modeling-planning-problems.adoc#planningListVariable[list planning variables].
+By default, the solver uses the following move selectors:
+xref:optimization-algorithms/move-selector-reference.adoc#changeMoveSelector[Change],
+xref:optimization-algorithms/move-selector-reference.adoc#swapMoveSelector[Swap],
+xref:optimization-algorithms/move-selector-reference.adoc#kOptListMoveSelector[K-OPT].
 
 [#listChangeMoveSelector]
 === `ListChangeMoveSelector`

From 216306ee1e813b34b9996690f2da8c2a49f7c8df Mon Sep 17 00:00:00 2001
From: Fred <zepfred@gmail.com>
Date: Wed, 19 Aug 2026 19:03:49 -0300
Subject: [PATCH 2/2] chore: adddress comments

---
 .../move-selector-reference.adoc              | 22 +++++++++++++------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/docs/src/modules/ROOT/pages/optimization-algorithms/move-selector-reference.adoc b/docs/src/modules/ROOT/pages/optimization-algorithms/move-selector-reference.adoc
index ee8b614f62..052303f5e0 100644
--- a/docs/src/modules/ROOT/pages/optimization-algorithms/move-selector-reference.adoc
+++ b/docs/src/modules/ROOT/pages/optimization-algorithms/move-selector-reference.adoc
@@ -1081,9 +1081,6 @@ only set the distribution type (so without a `distributionSizeMaximum` parameter
 
 These moves are applicable to planning variables that aren’t part of a list,
 also called xref:domain-modeling/modeling-planning-problems.adoc#planningVariable[basic variables].
-By default, the solver uses the following move selectors:
-xref:optimization-algorithms/move-selector-reference.adoc#changeMoveSelector[Change],
-xref:optimization-algorithms/move-selector-reference.adoc#swapMoveSelector[Swap].
 
 [#changeMoveSelector]
 === `ChangeMoveSelector`
@@ -1489,14 +1486,17 @@ public class MyStageProvider implements BasicVariableStageProvider<Schedule, Shi
 }
 ----
 
+[NOTE]
+====
+By default, the solver uses the moves
+xref:optimization-algorithms/move-selector-reference.adoc#changeMoveSelector[Change] and
+xref:optimization-algorithms/move-selector-reference.adoc#swapMoveSelector[Swap].
+====
+
 [#listMoveSelectors]
 == Move selectors for list variables
 
 These moves are applicable to xref:domain-modeling/modeling-planning-problems.adoc#planningListVariable[list planning variables].
-By default, the solver uses the following move selectors:
-xref:optimization-algorithms/move-selector-reference.adoc#changeMoveSelector[Change],
-xref:optimization-algorithms/move-selector-reference.adoc#swapMoveSelector[Swap],
-xref:optimization-algorithms/move-selector-reference.adoc#kOptListMoveSelector[K-OPT].
 
 [#listChangeMoveSelector]
 === `ListChangeMoveSelector`
@@ -1766,6 +1766,14 @@ public class MyStageProvider implements ListVariableStageProvider<RoutePlan, Veh
 }
 ----
 
+[NOTE]
+====
+By default, the solver uses the moves
+xref:optimization-algorithms/move-selector-reference.adoc#listChangeMoveSelector[Change],
+xref:optimization-algorithms/move-selector-reference.adoc#listSwapMoveSelector[Swap], and
+xref:optimization-algorithms/move-selector-reference.adoc#kOptListMoveSelector[K-OPT].
+====
+
 [#customMovesIntroduction]
 == Custom moves