Update schema_classes.py

schema_classes.py

@@ -4,23 +4,23 @@ from enum import Enum
 
 # These are the necessary components that make up the Trials 
 class Variables(BaseModel):
-    controlled: Union[List[str], None] = Field(..., title="Controlled Variables", description="A list of controlled variables, which will be constant (controlled) across all trials")
-    independent: Union[List[str], None] = Field(..., title="Independent Variables", description="A list of independent variables (ie treatments), which will be intentionally varied across one or more trials")
-    outcome: Union[List[str], None] = Field(..., title="Outcome Variables", description="A list of outcome variables (ie dependent or response variables)")
+    controlled: Union[List[str], None] = Field(..., title="Controlled Variables", description="An array of controlled variables, which will be constant (controlled) across all trials")
+    independent: Union[List[str], None] = Field(..., title="Independent Variables", description="An array of independent variables (ie treatments), which will be intentionally varied across one or more trials")
+    outcome: Union[List[str], None] = Field(..., title="Outcome Variables", description="An array of outcome variables (ie dependent or response variables) which is hypothesized to change across the trials")
 
 class Treatment(BaseModel):
     name: Union[str, None] = Field(..., title="Name", description="The treatment name")
     description: Union[str, None] = Field(..., title="Description", description="The treatment description, including the conditions within this treatment")
-    crops: Union[List[str], None] = Field(..., title="Crops", description="A list of crops being tested in this treatment")
-    fields: Union[List[str], None] = Field(..., title="Fields", description="A list of fields in which this treatment has occured or will occur")
-    learnings: Union[List[str], None] = Field(..., title="Learnings", description="A list of lessons learned from this experiment")
+    crops: Union[List[str], None] = Field(..., title="Crops", description="An array of crops being tested in this treatment")
+    fields: Union[List[str], None] = Field(..., title="Fields", description="An array of fields in which this treatment has occurred or will occur")
+    learnings: Union[List[str], None] = Field(..., title="Learnings", description="An array of lessons learned from this experiment")
     variables: Union[Variables, None] = Field(..., title="Variables", description="Variables (ie factors) in this experiment. Some variables are constant (controlled) and some will vary in order to learn something (independent)")
-    confoundingFactors: Union[List[str], None] = Field(..., title="Confounding Factors", description="A list of factors which may impact the outcomes of the experiment that were not planned for")
+    confoundingFactors: Union[List[str], None] = Field(..., title="Confounding Factors", description="An array of factors which may impact the outcomes of the experiment that were not planned for.")
 
 class Trial(BaseModel):
     name: Union[str, None] = Field(..., title="Name", description="The name of this trial") 
     description: Union[str, None] = Field(..., title="Description", description="A description of this trial") 
-    treatments: Union[List[Treatment], None] = Field(..., title="Treatments", description="A list of different treatments (strips or blocks with the same conditions applied) performed by the partner") 
+    treatments: Union[List[Treatment], None] = Field(..., title="Treatments", description="An array of different treatments (strips or blocks with the same conditions applied) performed by the partner") 
 
 class TrialLite(BaseModel):
     name: Union[str, None] = Field(..., title="Name", description="The name of this trial") 
@@ -40,10 +40,10 @@ class Person(BaseModel):
     role: Union[Role, None] = Field(..., title="Role", description="Role of this person")
     
 class Interactions(BaseModel):
-    people: Union[List[Person], None] = Field(..., title="People", description="People involved or mentioned during interaction")
+    people: Union[List[Person], None] = Field(..., title="People", description="An array of people involved in or mentioned in this interaction")
     date: Union[str, None] = Field(..., title="Date", description="Date of the interaction in ISO 8601 format (YYYY-MM-DD)", example="2024-10-05")
-    nextMeeting: Union[str, None] = Field(..., title="Date of next meeting", description="Proposed date of the next future interaction")
-    nextSteps: Union[List[str], None] = Field(..., title="Next Steps", description="List of individual next steps derived from the interaction")
+    nextMeeting: Union[str, None] = Field(..., title="Date of next meeting", description="Proposed date of the next future interaction in ISO 8601 format (YYYY-MM-DD)", example="2024-10-05")
+    nextSteps: Union[List[str], None] = Field(..., title="Next Steps", description="Array containing a list of next steps from the interaction")
     summary: Union[str, None] = Field(..., title="Summary", description="Summary of the interaction")
 
 class InteractionsLite(BaseModel):
@@ -114,14 +114,14 @@ class Planting(BaseModel):
     status: Union[Status, None] = Field(..., title="Status", description="The status of the planting. \"active\" is a planting which is currently still in the field.  \"archived\" is a planting which is no longer in the field (has been terminated or harvested)")
     crop: Union[List[str], None] = Field(..., title="Crop", description="A list of the crops in this planting")
     variety: Union[List[str], None] = Field(..., title="Variety", description="A list of the crop varieties in this planting")
-    logs: Union[List[Log], None] = Field(..., title="Logs", description="A list of all the logs that are associated with the farm activities")
-    soil: Union[List[Soil], None] = Field(..., title="Soil", description="A single soil profile for this planting, containing only one soil description")
+    logs: Union[List[Log], None] = Field(..., title="Logs", description="An array of all logs that are associated with this individual planting")
+    soil: Union[List[Soil], None] = Field(..., title="Soil", description="Information about the soil associated with or observed during the time of this planting")
     yield_: Union[List[Yield], None] = Field(..., title="Yield", description="One set of quantitative and qualitative yield observations for this planting") 
 
 class FarmActivities(BaseModel):
     name: Union[str, None] = Field(..., title="Name", description="The name of the agricultural field.")
     description: Union[str, None] = Field(..., title="Description", description="The description of the agricultural field.")
-    plantings: Union[List[Planting], None] = Field(..., title="Plantings", description="All of the plantings which have occurred on this field.")
+    plantings: Union[List[Planting], None] = Field(..., title="Plantings", description="An array of all the plantings which have occurred on this field")
 
 # These are extra for the modular approach (step-wise)
 class FarmActivitiesLite(BaseModel):
@@ -131,6 +131,6 @@ class FarmActivitiesLite(BaseModel):
 class PlantingLite(BaseModel):
     name: Union[str, None] = Field(..., title="Name", description="The name of the planting")
     status: Union[Status, None] = Field(..., title="Status", description="The status of the planting. \"active\" is a planting which is currently still in the field.  \"archived\" is a planting which is no longer in the field (has been terminated or harvested)")
-    crop: Union[List[str], None] = Field(..., title="Crop", description="A list of the crops in this planting")
-    variety: Union[List[str], None] = Field(..., title="Variety", description="A list of the crop varieties in this planting")
+    crop: Union[List[str], None] = Field(..., title="Crop", description="An array of the crops in this planting")
+    variety: Union[List[str], None] = Field(..., title="Variety", description="An array of the varieties in this planting")