chore: prune boilerplate and refresh stale docs

- Remove 257 redundant per-definition comment stubs across the package
- Drop dead nonlocal declarations in autoslicer_detection.py
- Document the swapped flag and swap_left_right in architecture docs
- Remove unsupported 'legacy override' claims from autotune/runtime docs

scanslicer/controller_params.py

@@ -1,9 +1,7 @@
 from PySide6.QtWidgets import QComboBox, QInputDialog, QMessageBox, QSlider
 
 
-# ScanSlicerParamsMixin: class definition for ScanSlicer behavior.
 class ScanSlicerParamsMixin:
-    # set_autotune_profile: function definition for ScanSlicer behavior.
     def set_autotune_profile(self, profile_name):
         normalized = self.autoslicer.normalize_autotune_profile(profile_name)
         self.autotune_profile = normalized
@@ -14,12 +12,10 @@ class ScanSlicerParamsMixin:
             dropdown.setCurrentText(normalized)
             dropdown.blockSignals(False)
 
-    # set_show_advanced_parameters: function definition for ScanSlicer behavior.
     def set_show_advanced_parameters(self, checked):
         self.show_advanced_params = bool(checked)
         self.update_parameter_visibility()
 
-    # sync_param_controls_from_model: function definition for ScanSlicer behavior.
     def sync_param_controls_from_model(self):
         self.updating_param_controls = True
         for name, p in self.params.items():
@@ -33,7 +29,6 @@ class ScanSlicerParamsMixin:
         self.updating_param_controls = False
         self.update_parameter_visibility()
 
-    # update_parameter_visibility: function definition for ScanSlicer behavior.
     def update_parameter_visibility(self):
         pipeline = self.params.detect_pipeline.get()
         method = self.params.bw_method.get()
@@ -59,7 +54,6 @@ class ScanSlicerParamsMixin:
                 is_visible = False
             block.setVisible(is_visible)
 
-    # load_default_parameters: function definition for ScanSlicer behavior.
     def load_default_parameters(self):
         mode = self.params.load_defaults()
         self.sync_param_controls_from_model()
@@ -69,7 +63,6 @@ class ScanSlicerParamsMixin:
         else:
             self.update_statusbar("Loaded factory defaults (no saved defaults found).")
 
-    # save_default_parameters: function definition for ScanSlicer behavior.
     def save_default_parameters(self):
         try:
             path = self.params.save_user_defaults()
@@ -80,7 +73,6 @@ class ScanSlicerParamsMixin:
 
         self.update_statusbar("Saved defaults to " + path)
 
-    # autotune_parameters: function definition for ScanSlicer behavior.
     def autotune_parameters(self):
         if self.processing_busy:
             return
@@ -89,7 +81,6 @@ class ScanSlicerParamsMixin:
             return
         self._start_autotune_worker()
 
-    # clear_autotune_history: function definition for ScanSlicer behavior.
     def clear_autotune_history(self):
         if self.processing_busy:
             return
@@ -125,7 +116,6 @@ class ScanSlicerParamsMixin:
         )
         self.update_statusbar("Auto-tune history cleared.")
 
-    # set_preset_dropdown_custom: function definition for ScanSlicer behavior.
     def set_preset_dropdown_custom(self):
         if self.preset_dropdown.currentText() == "Custom":
             return
@@ -133,7 +123,6 @@ class ScanSlicerParamsMixin:
         self.preset_dropdown.setCurrentText("Custom")
         self.preset_dropdown.blockSignals(False)
 
-    # refresh_preset_dropdown: function definition for ScanSlicer behavior.
     def refresh_preset_dropdown(self, selected_name=None):
         if selected_name is None:
             selected_name = self.preset_dropdown.currentText()
@@ -149,7 +138,6 @@ class ScanSlicerParamsMixin:
             self.preset_dropdown.setCurrentText("Custom")
         self.preset_dropdown.blockSignals(False)
 
-    # save_current_as_preset: function definition for ScanSlicer behavior.
     def save_current_as_preset(self):
         if self.processing_busy:
             return
@@ -184,7 +172,6 @@ class ScanSlicerParamsMixin:
         self.refresh_preset_dropdown(selected_name=saved_name)
         self.update_statusbar("Saved preset: " + saved_name)
 
-    # delete_current_preset: function definition for ScanSlicer behavior.
     def delete_current_preset(self):
         if self.processing_busy:
             return
@@ -216,7 +203,6 @@ class ScanSlicerParamsMixin:
         self.refresh_preset_dropdown(selected_name="Custom")
         self.update_statusbar("Deleted preset: " + deleted_name)
 
-    # apply_parameter_preset: function definition for ScanSlicer behavior.
     def apply_parameter_preset(self, preset_name):
         if preset_name == "Custom":
             return