diff --git a/parsl/providers/provider_base.py b/parsl/providers/provider_base.py
index <HASH>..<HASH> 100644
--- a/parsl/providers/provider_base.py
+++ b/parsl/providers/provider_base.py
@@ -29,7 +29,15 @@ class JobState(bytes, Enum):
 
 
 class JobStatus(object):
-    """Encapsulates a job state together with other details, presently a (error) message"""
+    """Encapsulates a job state together with other details:
+
+    Args:
+        state: The machine-reachable state of the job this status refers to
+        message: Optional human readable message
+        exit_code: Optional exit code
+        stdout_path: Optional path to a file containing the job's stdout
+        stderr_path: Optional path to a file containing the job's stderr
+    """
     SUMMARY_TRUNCATION_THRESHOLD = 2048
 
     def __init__(self, state: JobState, message: Optional[str] = None, exit_code: Optional[int] = None,
Elaborate JobStatus docstring to include stdout/err/state info (#<I>)