docs: describe what the parallel debug flag actually controls

- GetPageParam, UploadPageParam and DeletePageParam
- the flag is only read as parallelize(flush_at_end=...)
- it keeps or discards the messages the workers already logged
- warnings and errors are written out either way

Author: LukasGold

src/osw/wtsite.py

@@ -352,7 +352,9 @@ class GetPageParam(OswBaseModel):
         retry_delay_s: Optional[int] = 5
         """Retry delay in seconds"""
         debug: Optional[bool] = False
-        """Whether to log debug messages"""
+        """Only has an effect when parallel is True. If True, the messages logged
+        while the pages are fetched are written out once the batch has finished.
+        If False, only warnings and errors are written out."""
         raise_exception: Optional[bool] = False
         """Whether to raise an exception if an error occurs"""
         raise_warning: Optional[bool] = True
@@ -667,7 +669,9 @@ class UploadPageParam(OswBaseModel):
         parallel: Optional[bool] = False
         """If True, uploads the pages in parallel."""
         debug: Optional[bool] = False
-        """If True, debug messages will be logged."""
+        """Only has an effect when parallel is True. If True, the messages logged
+        while the pages are uploaded are written out once the batch has finished.
+        If False, only warnings and errors are written out."""
         comment: Optional[str] = None
         """Edit comment for the page history, applied to every uploaded page."""
 
@@ -783,7 +787,9 @@ class DeletePageParam(OswBaseModel):
         page: Union["WtPage", List["WtPage"], str, List[str]]
         comment: Optional[str] = None
         debug: Optional[bool] = True
-        """If True, debug messages will be logged."""
+        """Only has an effect when parallel is True. If True, the messages logged
+        while the pages are deleted are written out once the batch has finished.
+        If False, only warnings and errors are written out."""
         parallel: Optional[bool] = None
         """If true, processes the pages in parallel."""