Rationalize/simplify education-related properties (#2428)

* Adding properties for teaches and assesses to CreativeWork and EducationEvent; extending range of educationLevel, adding guidance to educationalAlignment, amending examples.

* referencing issue 2427

* referencing learning outcomes in defitions to fulfil requirement of #2432

Author: philbarker

data/ext/pending/issue-1779.rdfa

@@ -24,6 +24,8 @@
       <span class="h" property="rdfs:label">educationalLevel</span>
       <span property="rdfs:comment">The level in terms of progression through an educational or training context. Examples of educational levels include 'beginner', 'intermediate' or 'advanced', and formal sets of level indicators.</span>
       <span>domainIncludes: <a property="http://schema.org/domainIncludes" href="http://schema.org/EducationalOccupationalCredential">EducationalOccupationalCredential</a></span>
+      <span>domainIncludes: <a property="http://schema.org/domainIncludes" href="http://schema.org/CreativeWork">CreativeWork</a></span>
+      <span>domainIncludes: <a property="http://schema.org/domainIncludes" href="http://schema.org/EducationEvent">EducationEvent</a></span>
       <span>rangeIncludes: <a property="http://schema.org/rangeIncludes" href="http://schema.org/Text">Text</a></span>
       <span>rangeIncludes: <a property="http://schema.org/rangeIncludes" href="http://schema.org/URL">URL</a></span>
       <span>rangeIncludes: <a property="http://schema.org/rangeIncludes" href="http://schema.org/DefinedTerm">DefinedTerm</a></span>

data/ext/pending/issue-2427.rdfa

@@ -0,0 +1,29 @@
+<div>
+<!-- provides properties teaches and assesses for CreativeWork and EducationEvent, issue 2427 -->
+
+
+<div typeof="rdf:Property" resource="http://schema.org/teaches">
+  <span>Category: <span property="schema:category">issue-2427</span></span>
+  <span class="h" property="rdfs:label">teaches</span>
+  <span property="rdfs:comment">The item being described is intended to help a person learn the competency or learning outcome defined by the referenced term.</span>
+  <span>domainIncludes: <a property="http://schema.org/domainIncludes" href="http://schema.org/CreativeWork">CreativeWork</a></span>
+  <span>domainIncludes: <a property="http://schema.org/domainIncludes" href="http://schema.org/EducationEvent">EducationEvent</a></span>
+  <span>rangeIncludes: <a property="http://schema.org/rangeIncludes" href="http://schema.org/DefinedTerm">DefinedTerm</a></span>
+  <span>rangeIncludes: <a property="http://schema.org/rangeIncludes" href="http://schema.org/Text">Text</a></span>
+  <link property="http://schema.org/isPartOf" href="http://pending.schema.org" />
+  <span>Source:  <a property="dc:source" href="https://github.com/schemaorg/schemaorg/issues/2427">#2427</a></span>
+</div>
+
+<div typeof="rdf:Property" resource="http://schema.org/assesses">
+  <span>Category: <span property="schema:category">issue-2427</span></span>
+  <span class="h" property="rdfs:label">assesses</span>
+  <span property="rdfs:comment">The item being described is intended to assess the competency or learning outcome defined by the referenced term.</span>
+  <span>domainIncludes: <a property="http://schema.org/domainIncludes" href="http://schema.org/CreativeWork">CreativeWork</a></span>
+  <span>domainIncludes: <a property="http://schema.org/domainIncludes" href="http://schema.org/EducationEvent">EducationEvent</a></span>
+  <span>rangeIncludes: <a property="http://schema.org/rangeIncludes" href="http://schema.org/DefinedTerm">DefinedTerm</a></span>
+  <span>rangeIncludes: <a property="http://schema.org/rangeIncludes" href="http://schema.org/Text">Text</a></span>
+  <link property="http://schema.org/isPartOf" href="http://pending.schema.org" />
+  <span>Source:  <a property="dc:source" href="https://github.com/schemaorg/schemaorg/issues/2427">#2427</a></span>
+</div>
+
+</div>

data/schema.rdfa

@@ -2444,7 +2444,9 @@ The place is __open__ if the [[opens]] property is specified, and __closed__ oth
 
     <div typeof="rdfs:Class" resource="http://schema.org/AlignmentObject">
       <span class="h" property="rdfs:label">AlignmentObject</span>
-      <span property="rdfs:comment">An intangible item that describes an alignment between a learning resource and a node in an educational framework.</span>
+      <span property="rdfs:comment">An intangible item that describes an alignment between a learning resource and a node in an educational framework.
+
+Should not be used where the nature of the alignment can be described using a simple property, for example to express that a resource [[teaches]] or [[assesses]] a competency.</span>
        <span>Subclass of: <a property="rdfs:subClassOf" href="http://schema.org/Intangible">Intangible</a></span>
        <span>Source:  <a property="dc:source" href="http://www.w3.org/wiki/WebSchemas/SchemaDotOrgSources#source_LRMIClass">LRMIClass</a></span></div>
 
@@ -3624,7 +3626,7 @@ The place is __open__ if the [[opens]] property is specified, and __closed__ oth
     </div>
     <div typeof="rdf:Property" resource="http://schema.org/alignmentType">
       <span class="h" property="rdfs:label">alignmentType</span>
-      <span property="rdfs:comment">A category of alignment between the learning resource and the framework node. Recommended values include: 'assesses', 'teaches', 'requires', 'textComplexity', 'readingLevel', 'educationalSubject', and 'educationalLevel'.</span>
+      <span property="rdfs:comment">A category of alignment between the learning resource and the framework node. Recommended values include: 'requires', 'textComplexity', 'readingLevel', and 'educationalSubject'.</span>
       <span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.org/AlignmentObject">AlignmentObject</a></span>
       <span>Range: <a property="http://schema.org/rangeIncludes" href="http://schema.org/Text">Text</a></span>
     </div>
@@ -4715,7 +4717,9 @@ Dateline summaries are oriented more towards human readers than towards automate
     </div>
     <div typeof="rdf:Property" resource="http://schema.org/educationalAlignment">
       <span class="h" property="rdfs:label">educationalAlignment</span>
-      <span property="rdfs:comment">An alignment to an established educational framework.</span>
+      <span property="rdfs:comment">An alignment to an established educational framework.
+
+This property should not be used where the nature of the alignment can be described using a simple property, for example to express that a resource [[teaches]] or [[assesses]] a competency.</span>
       <span>Domain: <a property="http://schema.org/domainIncludes" href="http://schema.org/CreativeWork">CreativeWork</a></span>
       <span>Range: <a property="http://schema.org/rangeIncludes" href="http://schema.org/AlignmentObject">AlignmentObject</a></span>
     </div>