update doc strings

guardrails/classes/history/call.py

@@ -211,7 +211,7 @@ def validation_response(self) -> Optional[Union[str, Dict, ReAsk]]:
         """The aggregated responses from the validation process across all
         iterations within the current call.
 
-        Could contain ReAsks.
+        This value could contain ReAsks.
         """
         number_of_iterations = self.iterations.length
 
@@ -261,7 +261,13 @@ def fixed_output(self) -> Optional[Union[str, Dict]]:
 
     @property
     def guarded_output(self) -> Optional[Union[str, Dict]]:
-        """The final output after undergoing validation.
+        """The complete validated output after all stages of validation are
+        completed.
+
+        This property contains the aggregate validated output after all
+        validation stages have been completed. Some values in the
+        validated output may be "fixed" values that were corrected
+        during validation.
 
         This will only have a value if the Guard is in a passing state.
         """

guardrails/classes/history/iteration.py

@@ -102,10 +102,11 @@ def validation_output(self) -> Optional[Union[ReAsk, str, Dict]]:
 
     @property
     def guarded_output(self) -> Optional[Union[str, Dict]]:
-        """Any valid output after undergoing validation.
+        """Any valid values after undergoing validation.
 
-        Could be a partial structure if field level reasks occur.
-        Could contain fixed values.
+        Some values in the validated output may be "fixed" values that
+        were corrected during validation. This property may be a partial
+        structure if field level reasks occur.
         """
         return self.outputs.guarded_output
 

guardrails/classes/history/outputs.py

@@ -27,9 +27,10 @@ class Outputs(ArbitraryModel):
         description="The response from the validation process.", default=None
     )
     guarded_output: Optional[Union[str, Dict]] = Field(
-        description="Any valid output after validation."
-        "Could be a partial structure if field level reasks occur."
-        "Could contain fixed values.",
+        description="""Any valid values after undergoing validation.
+
+        Some values may be "fixed" values that were corrected during validation.
+        This property may be a partial structure if field level reasks occur.""",
         default=None,
     )
     reasks: Sequence[ReAsk] = Field(