Identifying when course events happen

From Schema Course extension Community Group
Jump to: navigation, search
Schema Course Extension Wiki
Navigation
Main Page
Outline use cases
Example sites
Other useful links
Community group home page
email list for group
schema.org Git hub issue
Requirement e) "must be able to identify the dates and times at which individual course events are offered" arises from use case 1.3 refining UC1 by the time of events, where the searcher is concerned about the dates and times at which course events are offered. In this case it is the individual component events of the course (classes, workshops, tutorials etc.) that are of concern. Such component events are often repeated at a regular slot (e.g. a course may have a lab class every Tuesday afternoon from 14:00 to 17:00). The times and dates will vary from one Course Instance to another.

See also: identifying the start and end of a course.

Proposal

Use the subEvent property of a CourseInstance inherited from Event to identify the component events. The component events will typically be EducationEvents. Use the startDate and endDate of these component events to convey the required information.

Note: See also EventSeries issue for schema.org and illustrated concrete proposal.

See email discussion thread starting at dates of a course and previous thread on Dates and locations of a CourseInstance & the lessons it comprises.

Example

Based on Edinburgh Community Learning example

PRE-MARKUP:
Course
  name: Cake Decoration
  hasCourseInstance: CourseInstance
    name: Spring 2016 Offering
    subEvent: EducationEvent
      startDate: 2016-04-19T19:00:00
      endDate:   2016-04-19T21:00:00
    subEvent: EducationEvent
      startDate: 2016-04-26T19:00:00
      endDate:   2016-04-26T21:00:00

MICRODATA:
<!--TODO-->

RDFA:
<body  vocab="http://schema.org/">
<!-- content -->
<div typeof="Course">
  <h1><span property="name">Cake Decoration</span> - Beginner - (19/4) - BHS36452</h1>
  <div property="hasCourseInstance" typeof="CourseInstance">
     <h2 property="name">Spring 2016 Offering</h2>
     <h3>Dates and times</h3>
      <table>
        <thead>
          <tr>
            <th>Date</th>
            <th>Day</th>
            <th>Time</th>
          </tr>
        </thead>
        <tbody>
          <tr property="subEvent" typeof="EducationEvent">
            <td>
              <meta property="startDate" content="20160419T1900">
              <meta property="endDate" content="20160419T2100">
               19 Apr 2016</td>
            <td>Tuesday</td>
            <td>07:00 pm - 09:00 pm</td>
          </tr>
          <tr property="subEvent" typeof="EducationEvent">
            <td>
              <meta property="startDate" content="20160426T1900">
              <meta property="endDate" content="20160426T2100">
               26 Apr 2016</td>
            <td>Tuesday</td>
            <td>07:00 pm - 09:00 pm</td>
          </tr>
        </tbody>
      </table>
  </div>  <!--end course instance info-->
</div>  <!--end course info-->
</body>

JSON:
<!--TODO-->