pdoc-dockstrings ergänzt

__init__.py

@@ -1,3 +1,17 @@
+"""sn_plan41 – QGIS-Plugin für thematische Linklisten und Datenquellen.
+Verwaltet Excel-basierte Link-Listen und Fachdatenabruf.
+"""
+
+
 def classFactory(iface):
+    """Factory-Funktion für QGIS.
+    Wird von QGIS aufgerufen, um die Plugin-Instanz zu erstellen.
+    
+    Args:
+        iface: QGIS-Schnittstellenobjekt
+        
+    Returns:
+        Plan41: Instanziiertes Plugin
+    """
     from .main import Plan41
     return Plan41(iface)

main.py

@@ -1,4 +1,6 @@
-# sn_plan41/main.py
+"""sn_plan41/main.py – Einstiegspunkt des sn_plan41 Plugins.
+Orchestriert die UI und den Datenabruf für Thematische Linklisten.
+"""
 
 from qgis.utils import plugins
 from sn_basis.ui.dockmanager import DockManager
@@ -8,6 +10,9 @@ from sn_basis.modules.Pruefmanager import Pruefmanager
 
 
 class Plan41:
+    """Einstiegspunkt des sn_plan41-Plugins.
+    Verwaltet die DockWidget-Initialisierung und den Datenflusss.
+    """
     def __init__(self, iface):
         self.iface = iface
         self.pruefmanager=Pruefmanager(ui_modus="qgis")

modules/listenauswerter.py

@@ -1,4 +1,7 @@
-#sn_plan41/modules/listenauswerter.py
+"""sn_plan41/modules/listenauswerter.py – Validierung von Linklisten.
+Prüft Zeilen aus DataDict auf Vollständigkeit und Konsistenz.
+"""
+
 from typing import Any, Dict, List, Mapping, Optional, Tuple
 from collections.abc import Mapping as _Mapping
 # Prüfer-Typen (werden als Instanzen erwartet)

tests/__init__.py

@@ -1 +1,3 @@
-#Testordner
+"""sn_plan41/tests – Test-Suite für das sn_plan41 Plugin.
+Enthält Unit-Tests und Integrationstests für Tab-Logik und Datengrabber.
+"""

ui/dockwidget.py

@@ -1,4 +1,7 @@
-#sn_plan41/ui/dockwidget.py
+"""sn_plan41/ui/dockwidget.py – Haupt-DockWidget für sn_plan41.
+Verwaltet die Tabs für Linkvalidierung, Druck und Einstellungen.
+"""
+
 from sn_basis.ui.tabs.settings_tab import SettingsTab 
 from sn_plan41.ui.tab_a_ui import TabA 
 from sn_basis.ui.tabs.print_tab import PrintTab
@@ -8,9 +11,25 @@ from sn_basis.functions.message_wrapper import error
 
 
 class DockWidget(BaseDockWidget):
+    """Haupt-DockWidget für sn_plan41 mit Tab-Verwaltung.
+    
+    Attributes:
+        tabs: Liste von Tab-Klassen (TabA, PrintTab, SettingsTab)
+        pruefmanager: Prüfmanager-Instanz für Validierung
+        data_grabber: DataGrabber-Instanz für Fachdatenabruf
+    """
+    
     tabs = [TabA, PrintTab, SettingsTab]
     
     def __init__(self, parent=None, subtitle="", pruefmanager=None, data_grabber=None):
+        """Initialisiert das DockWidget mit Services und Tabs.
+        
+        Args:
+            parent: Übergeordnetes Widget
+            subtitle: Untertitel des DockWidgets
+            pruefmanager: Prüfmanager-Instanz
+            data_grabber: DataGrabber-Instanz
+        """
         super().__init__(parent, subtitle)
         
         # Services als Attribute speichern

ui/tabs/tab_b.py

@@ -1,9 +1,24 @@
+"""sn_plan41/ui/tabs/tab_b.py – Beispiel-Tab für zusätzliche Funktionen.
+Ein Tab für zukünftige Erweiterungen.
+"""
+
 from qgis.PyQt.QtWidgets import QWidget, QVBoxLayout, QLabel, QTextEdit
 
 class TabB(QWidget):
+    """Beispiel-Tab für sn_plan41.
+    
+    Attributes:
+        tab_title: Anzeigetitel des Tabs ("Tab B")
+    """
+    
     tab_title = "Tab B"
     
     def __init__(self, parent=None):
+        """Initialisiert den Tab mit Beispielinhalt.
+        
+        Args:
+            parent: Übergeordnetes Widget
+        """
         super().__init__(parent)
         layout = QVBoxLayout()
         layout.addWidget(QLabel("Plugin2 – Tab B"))