@@ -131,14 +131,23 @@ Item {
131131 property int sideStageWidth: units.gu(40)
132132 property bool sideStageVisible: priv.sideStageAppId
133133
134+ // Phase of the animation:
135+ // 0: Starting from right edge, a new app (index 1) comes in from the right
136+ // 1: The app has reached the first snap position.
137+ // 2: The list is dragged further and snaps into the spread view when entering phase 2
134138 property int phase
135139
136140 property int phase0Width: sideStageWidth
137141 property int phase1Width: sideStageWidth
138142
143+ // Those markers mark the various positions in the spread (ratio to screen width from right to left):
144+ // 0 - 1: following finger, snap back to the beginning on release
139145 property real positionMarker1: 0.2
146+ // 1 - 2: curved snapping movement, snap to nextInStack on release
140147 property real positionMarker2: sideStageWidth / spreadView.width
148+ // 2 - 3: movement follows finger, snaps to phase 2 (full spread) on release
141149 property real positionMarker3: 0.6
150+ // passing 3, we detach movement from the finger and snap to phase 2 (full spread)
142151 property real positionMarker4: 0.8
143152
144153 property int startSnapPosition: phase0Width * 0.5
@@ -187,7 +196,7 @@ Item {
187196
188197 states: [
189198 State {
190− name: "invalid"
199+ name: "empty"
191200 },
192201 State {
193202 name: "main"
@@ -212,7 +221,7 @@ Item {
212221 if (priv.mainStageAppId && priv.sideStageAppId) {
213222 return "mainAndOverlay";
214223 }
215− return "invalid";
224+ return "empty";
216225 }
217226
218227 onContentXChanged: {