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/main.py

@@ -18,7 +18,6 @@ from .controller import ScanSlicerControllerMixin
 from .ui_builders import ScanSlicerUiBuilderMixin
 
 
-# _unwrap_qvariant: function definition for ScanSlicer behavior.
 def _unwrap_qvariant(value):
     unwrapped = value
     for _ in range(4):
@@ -45,7 +44,6 @@ def _unwrap_qvariant(value):
     return unwrapped
 
 
-# _read_portal_dark_preference: function definition for ScanSlicer behavior.
 def _read_portal_dark_preference():
     try:
         from PySide6.QtDBus import QDBusConnection, QDBusInterface, QDBusMessage
@@ -94,7 +92,6 @@ def _read_portal_dark_preference():
     return None
 
 
-# apply_dark_theme_if_requested: function definition for ScanSlicer behavior.
 def apply_dark_theme_if_requested(app):
     theme_value = os.environ.get("GTK_THEME", "").lower()
     dark_theme_requested = "dark" in theme_value
@@ -131,7 +128,6 @@ def apply_dark_theme_if_requested(app):
     app.setPalette(palette)
 
 
-# apply_global_text_size_offset: function definition for ScanSlicer behavior.
 def apply_global_text_size_offset(app, pixel_offset=2):
     font = app.font()
     info = QFontInfo(font)
@@ -148,7 +144,6 @@ def apply_global_text_size_offset(app, pixel_offset=2):
     app.setFont(font)
 
 
-# resolve_app_icon: function definition for ScanSlicer behavior.
 def resolve_app_icon():
     icon = QIcon.fromTheme("scanslicer")
     if not icon.isNull():
@@ -175,7 +170,6 @@ def resolve_app_icon():
     return QIcon()
 
 
-# QtScanSlicer: class definition for ScanSlicer behavior.
 class QtScanSlicer(QMainWindow, ScanSlicerUiBuilderMixin, ScanSlicerControllerMixin):
     CONTROL_PANEL_WIDTH = 370
     STEPPER_WIDTH = 75
@@ -325,7 +319,6 @@ class QtScanSlicer(QMainWindow, ScanSlicerUiBuilderMixin, ScanSlicerControllerMi
         "PSJNOCAxMmg4Ii8+PC9zdmc+"
     )
 
-    # __init__: function definition for ScanSlicer behavior.
     def __init__(self, startup_dir=None):
         super().__init__()
 
@@ -402,7 +395,6 @@ class QtScanSlicer(QMainWindow, ScanSlicerUiBuilderMixin, ScanSlicerControllerMi
         if startup_dir:
             self.open_directory(startup_dir)
 
-    # _build_header_controls: function definition for ScanSlicer behavior.
     def _build_header_controls(self, parent):
         header = QWidget(parent)
         header_layout = QHBoxLayout(header)
@@ -436,14 +428,12 @@ class QtScanSlicer(QMainWindow, ScanSlicerUiBuilderMixin, ScanSlicerControllerMi
         header_layout.addWidget(self.button_quit)
         return header
 
-    # toggle_maximize_restore: function definition for ScanSlicer behavior.
     def toggle_maximize_restore(self):
         if self.isMaximized():
             self.showNormal()
             return
         self.showMaximized()
 
-    # closeEvent: function definition for ScanSlicer behavior.
     def closeEvent(self, event):
         self._is_closing = True
         if hasattr(self, "autoslicer"):
@@ -452,7 +442,6 @@ class QtScanSlicer(QMainWindow, ScanSlicerUiBuilderMixin, ScanSlicerControllerMi
             self._close_status_log()
         super().closeEvent(event)
 
-# run_app: function definition for ScanSlicer behavior.
 def run_app(startup_dir=None):
     app = QApplication.instance()
     if app is None: