--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/schema.org/drafts/changes.html Tue Apr 10 16:31:05 2012 +0200
@@ -0,0 +1,142 @@
+<html>
+<head>
+ <title>Schema.org changes</title>
+</head>
+<body>
+
+<h1>Schema.org Changes</h1>
+
+<p>
+ This document describes changes to the schema.org schema. It serves as a summary of draft/pending changes, and later as a record of updates. For more detail of
+ proposals and drafts see the <a href="http://www.w3.org/wiki/WebSchemas/SchemaDotOrgProposals">proposals</a> listing.
+</p>
+
+<h2>Changes Pending (drafts)</h2>
+
+<h3>For Edition 0.91</h3>
+
+<p>Version 0.91 scheduled for mid-April 2012, to include resolution of <a href="http://www.w3.org/wiki/WebSchemas/Singularity">Singularity</a> issue (singular form of property names);
+ addition of <a href="http://www.w3.org/wiki/WebSchemas/Comment">Comment</a>, and <a href="http://www.w3.org/wiki/WebSchemas/SoftwareApplicationSchema">SoftwareApplication</a>.
+</p>
+
+<h4>Singularity changes:</h4>
+<ul>
+ <li>add new properties per <a href="http://www.w3.org/wiki/WebSchemas/Singularity">Singularity</a proposal>: 23 changes: actor, album, attendee, award, blogPost, colleague, contactPoint,
+ employee, encoding, episode, event, founder, map, member, parent, performer, photo, review, season, sibling, significantLink, subEvent, track.</li>
+ <li>How do we express the aliasing/replacement nature? For now, we simply add these. Future updates may indicate the earlier forms as archaic (in HTML and in a machine schema).
+ OR SHOULD WE DO THIS FOR NOW? ... append: "(legacy spelling; see singular form, xxxx)" for each of the definitions of the plural spelling?</li>
+ <li>album(s): "A collection of music albums."; new text: "A music album."</li>
+ <li>attendee(s): "A person attending the event."; new text: "A person or organization attending the event."</li>
+ <li>award(s): "Awards won by this person or for this creative work."; new text: "An award won by this person or for this creative work."</li>
+ <li>blogPost(s): "The postings that are part of this blog"; new text: "A posting that is part of this blog."</li>
+ <li>employee(s): "People working for this organization."; new text: "Someone working for this organization."</li>
+ <li>encoding(s): "The media objects that encode this creative work"; new text: "A media object that encode this CreativeWork.".</li>
+ <li>episode(s): (TODO: compare TV/Radio proposal) "The episode of a TV series or season."; new text: "An episode of a TV series or season."</li>
+ <li>event(s): "Upcoming or past events associated with this place or organization."; new text: "Upcoming or past event associated with this place or organization."</li>
+ <li>parent(s): "A parents of the person."; new text: "A parent of this person."</li>
+ <li>performer(s): "The main performer or performers of the event—for example, a presenter, musician, or actor."; new text: "A performer at the event — for example, a presenter, musician, musical group or actor."
+ <li>photo(s): "Photographs of this place."; new text: "A photograph of this place."</li>
+ <li>review(s): "Review of the item."; new text: "A review of the item."</li>
+ <li>season(s): "The seasons of the TV series."; new text: "A season of a TV series."</li>
+ <li>significantLink(s): "The most significant URLs on the page. Typically, these are the non-navigation links that are clicked on the most"; new text: "One of the more significant URLs on the page. Typically, these are the non-navigation links that are clicked on the most."
+ <li>subEvent(s): "Events that are a part of this event. For example, a conference event includes many presentations, each are subEvents of the conference."; new
+ text: "An Event that is part of this event. For example, a conference event includes many presentations, each are a subEvent of the conference."</li>
+ <li>These property definitions can be copied unchanged from the plural form: actor(s), colleague(s), contactPoint(s), founder(s), map(s), member(s), sibling(s), track(s)</li>
+ <li>Per-class Microdata Examples that need updating, to use new itemprop values. The examples are organized by type. Therefore...
+ TYPES: Movie: 'actor' not 'actors';
+ TYPES: TVSeries, TVSeason, TVEpisode: 'episode' not 'episodes'; 'season' not 'seasons';
+ TYPES: VideoObject, MusicGroup, MusicRecording, Event: 'event' not 'events';
+ TYPES: Product, AggregateRating, Offer, Review, Rating: 'review' not 'reviews';
+ TYPES: Person, PostalAddress: 'colleague' not 'colleagues';
+ TYPES: Organization, Address: 'member' not 'members';
+ TYPES: VideoObject, MusicGroup, MusicRecording, Event: 'track' not 'tracks';
+ </li>
+ <li>In <a href="http://schema.org/docs/extension.html">docs/extensions.html</a> remove old text "Properties that can take multiple values (such as parents) are plural and those that can take only a single value (such as dateOfBirth) are singular.". </li>
+</ul>
+
+<h4>Comment changes:</h4>
+
+<p>Based on <a href="http://www.w3.org/wiki/WebSchemas/Comment">Comment proposal</a>:
+
+<ul>
+<li>Add a new type, 'Comment', whose super-type is CreativeWork.</li>
+<li>The description should be: <em>'A comment on an item - for example, a comment on a blog post.'</em></li>
+<li>Change the description of <a href="http://schema.org/UserComments">UserComments</a> from old text, 'A comment about an item.' to new text 'The UserInteraction event in which a user comments on an item'.</li>
+<li>Add a 'text' property to the CreativeWork class, whose value is the Text of the work (and hence of a Comment also). The description should be: <em>'The textual content of this CreativeWork.''</em></li>
+</ul>
+
+<h4>SoftwareApplication changes:</h4>
+
+<p>Based on <a href="http://www.w3.org/wiki/WebSchemas/SoftwareApplicationSchema">SoftwareApplication proposal</a>:
+
+<p>(<em>Note, <a href="http://www.w3.org/wiki/images/b/b3/Schema.org-SoftwareApplicationsV2.pdf">proposal detail</a> had to be reworked to fit new singular idiom and URL/Url case</em>)</p>
+
+<p>Specifically: screenshots became screenshot; operatingSystems became operatingSystem; devices became device. Also 'browsers' became 'browserRequirements'.</p>
+
+<ul>
+<li>Add a new type, 'SoftwareApplication', whose super-type is CreativeWork. Properties:
+ <ul>
+ <li>New property 'operatingSystem", expected type Text, description 'Operating system required ("Windows 7", "OSX 10.6", "Android 1.6")' </li>
+ <li>New property 'device', expected type Text, description 'Device required to run the application. Used in cases where a specific make/model is required to run the application.'</li>
+ <li>New property 'fileSize', expected type Text, description 'Size of the application / package (e.g. 18MB). In the absence of a unit (MB, KB etc.), KB will be assumed.'</li>
+ <li>New property 'fileFormat', expected type Text, description 'MIME format of the binary (e.g. application/zip)'</li>
+ <li>New property 'applicationCategory', expected type Text, description 'Type of software application. e.g. Game, Multimedia.'</li>
+ <li>New property 'applicationSubCategory', expected type Text, description 'Subcategory of the application "e.g. Arcade Game".'</li>
+TODO fix caps *Url *URL
+ <li>New property 'downloadUrl', expected type URL, description 'If the file can be downloaded, URL to download the binary.'</li>
+ <li>New property 'softwareVersion', expected type Text, description 'Version of the software instance.'</li>
+ <li>New property 'releaseNotes', expected type URL or Text, description "Description of what changed in this version." </li>
+ <li>New property 'installUrl', expected type URL, description "URL at which the app may be installed, if different from the URL of the item"</li>
+ <li>New property 'requirements', expected type URL or Text, description 'Component dependency requirements for application. This includes runtime environments and shared libraries that are not included in the application distribution package , but required to run the application (Examples: DirectX, Java or .NET runtime).'</li>
+ <li>New property 'featureList', expected type URL or Text, description 'Features or modules provided by this application.'</li>
+ <li>New property 'screenshot', expected type ImageObject or URL, description 'A link to a screenshot image of the app.'</li>
+ <li>New property 'storageRequirements', expected type URL or Text, description 'Storage requirements (free space required).'</li>
+ <li>New property 'memoryRequirements', expected type Text, description 'Minimum memory requirements.'</li>
+ <li>New property 'processorRequirements', expected type Text, description 'Processor architecture required to run the application (e.g. IA64)'</li>
+TODO: country code ???
+ <li>New property 'countriesSupported', expected type Text, description 'Countries for which the application is supported. You can also provide the two-letter ISO 3166-1 alpha-2 country code.'</li>
+ <li>New property, 'countriesNotSupported', expected type Text, description 'Countries for which the application is not supported. You can also provide the two-letter ISO 3166-1 alpha-2 country code.'</li>
+ <li>New property, 'permissions', expected type Text, description 'Permission(s) required to run the app (for example, a mobile app may require full internet access or may run only on wifi).'</li>
+ <li>New property, 'applicationSuite', expected type Text, description 'The name of the application suite to which the application belongs (e.g. Excel belongs to Office)'</li>
+
+ </ul>
+</li>
+
+<li>Add a new type, 'MobileApplication', whose super-type is the new 'SoftwareApplication' class defined above. Properties:
+ <ul>
+ <li>new property, 'carrierRequirements', expected type Text, description 'Specifies specific carrier(s) requirements for the application (e.g. an application may only work on a specific carrier network).'</li>
+ </ul>
+</li>
+
+<li>Add a new type, 'WebApplication', whose super-type is the new 'SoftwareApplication' class defined above. Properties:
+ <ul>
+ <li>new property, 'browserRequirements', expected type Text, description 'Specifies browser requirements in human-readable text. For example, "requires HTML5 support".'</li>
+ </ul>
+</li>
+
+<li>TODO: If we are not adding the entire software categorisation enumeration, how exactly are these handled?
+ The example given in PDF has softwareApplicationSubCategory: Arcade and Action (i.e. text value), and yet softwareApplicationCategory as a link to http://schema.org/
+ GameApplication. These could be an example for external enumerations. For now we should type them as URL or Text for flexibility.
+ </li>
+
+</ul>
+
+<!-- notes for style guide: 'of a', 'of this', caps for classes? -->
+
+<h3>For Edition 0.92</h3>
+
+<p>Version 0.91 scheduled for late-April 2012, to include [...]TV and Radio amendments; others to be discussed.</p>
+
+<h3>For Edition 0.93</h3>
+
+<p>Version 0.91 scheduled for early May 2012, to include [to be discussed].</p>
+
+
+
+<h3>Change Log</h3>
+
+<p>None (as of 2012-04-10)</p>
+
+
+</body>
+</html>
\ No newline at end of file