comments pt1

app/src/main/java/com/example/jnicpp/bowling/BowlingCameraActivity.kt

@@ -369,6 +369,15 @@ class BowlingCameraActivity : AppCompatActivity(), CameraXController.Callback {
         debugSessionLogger.stop()
     }
 
+    /**
+     * @brief Advances the step index and updates the step button label.
+     *
+     * This method increments the current step index, cycling back to zero
+     * once the end of the [stepLabels] list is reached. It then updates the
+     * `btnShowStep` text to reflect the new step, ensuring the UI button
+     * always displays the correct label for the current position in the
+     * sequence.
+     */
     fun onStepIncrease() {
         currentStepIndex = (currentStepIndex + 1) % stepLabels.size
         binding.btnShowStep.setText(stepLabels[currentStepIndex])