Merge pull request #83 from Ed-Fi-Exchange-OSS/TPDMDEV-668

TPDMDEV-668 - Syncing documentation updates from requests made by the core team

Descriptor/EducatorRole.metaed

@@ -1,2 +1,2 @@
 Descriptor EducatorRole
-    documentation "The role authorized by the Certification (e.g., Principal, Reading Specialist), typically associated with service and administrative certifications."
+    documentation "The role authorized by the Credential or Certification (e.g., Principal, Reading Specialist), typically associated with service and administrative certifications."

Descriptor/EvaluationElementRatingLevel.metaed

@@ -1,2 +1,2 @@
 Descriptor EvaluationElementRatingLevel
-    documentation "The rating level achieved based upon the rating or score."
+    documentation "Rating levels for Evaluation Elements."

Descriptor/EvaluationRatingLevel.metaed

@@ -1,2 +1,2 @@
 Descriptor EvaluationRatingLevel
-    documentation "The rating level achieved based upon the rating or score."
+    documentation "Rating levels for Evaluations."

Descriptor/Gender.metaed

@@ -1,2 +1,2 @@
 Descriptor Gender
-  documentation "The gender with which a person associates."
+  documentation "A person's gender."

Descriptor/ObjectiveRatingLevel.metaed

@@ -1,2 +1,2 @@
 Descriptor ObjectiveRatingLevel
-    documentation "The rating level achieved based upon the rating or score."
+    documentation "Rating levels for Evaluation Objectives."

Descriptor/PerformanceEvaluationRatingLevel.metaed

@@ -1,2 +1,2 @@
 Descriptor PerformanceEvaluationRatingLevel
-    documentation "The rating level achieved based upon the rating or score."
+    documentation "Rating levels for Performance Evaluations."

Descriptor/RubricRatingLevel.metaed

@@ -1,2 +1,2 @@
 Descriptor RubricRatingLevel
-    documentation "The rating level achieved for the rubric dimension."
+    documentation "Rating levels for Rubric Dimensions."

DomainEntity/Candidate.metaed

@@ -13,7 +13,7 @@ Domain Entity Candidate
       documentation "Other names (e.g., alias, nickname, previous legal name) associated with a person."
       is optional collection
   descriptor EdFi.Sex
-      documentation "A person's gender."
+      documentation "The sex of the candidate."
       is required
   inline common EdFi.BirthData
       documentation "The set of elements that capture relevant data regarding a person's birth, including birth date and place of birth."
@@ -74,7 +74,7 @@ Domain Entity Candidate
       documentation "The login ID for the user; used for security access control interface."
       is optional
   descriptor Gender
-    documentation "The gender with which a person associates."
+    documentation "The gender of the candidate."
     is optional
   decimal TuitionCost
     documentation "The tuition for a person's participation in a program, service. or course."

DomainEntity/Credential.metaed

@@ -24,5 +24,5 @@ Domain Entity EdFi.Credential additions
         documentation "Reference to the person's Student Academic Records for the school(s) with which the Credential is associated."
         is optional collection
     descriptor EducatorRole
-        documentation "The role authorized by the Credential (e.g., Principal, Reading Specialist), typically associated with service and administrative certifications."
+        documentation "The specific roles or positions within an organization that the credential is intended to authorize (e.g., Principal, Reading Specialist), typically associated with service and administrative certifications."
         is optional