Improved docstrings for base modules

src/auto_archiver/core/feeder.py

@@ -1,3 +1,7 @@
+"""
+The feeder base module defines the interface for implementing feeders in the media archiving framework. 
+"""
+
 from __future__ import annotations
 from abc import abstractmethod
 from auto_archiver.core import Metadata
@@ -5,5 +9,17 @@ from auto_archiver.core import BaseModule
 
 class Feeder(BaseModule):
 
+    """
+    Base class for implementing feeders in the media archiving framework.
+
+    Subclasses must implement the `__iter__` method to define platform-specific behavior.
+    """
+
     @abstractmethod
-    def __iter__(self) -> Metadata: return None
+    def __iter__(self) -> Metadata:
+        """
+        Returns an iterator (use `yield`) over the items to be archived.
+        
+        These should be instances of Metadata, typically created with Metadata().set_url(url).
+        """
+        return None