cleaned up some todos
authorDan Brickley <danbri@danbri.org>
Tue, 10 Apr 2012 16:54:22 +0200
changeset 12 bfd49e62a730
parent 11 6c09cda6575f
child 13 e75121d150c2
cleaned up some todos
schema.org/drafts/changes.html
--- a/schema.org/drafts/changes.html	Tue Apr 10 16:46:39 2012 +0200
+++ b/schema.org/drafts/changes.html	Tue Apr 10 16:54:22 2012 +0200
@@ -31,7 +31,7 @@
     <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>episode(s): (this change also advocated for in the <a href="http://www.w3.org/wiki/WebSchemas/TVRadioSchema">TV/Radio proposal</a>) "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."
@@ -71,7 +71,9 @@
 
 <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>
+<p>
+Specifically: screenshots became screenshot; operatingSystems became operatingSystem; devices became device. Also 'browsers' became 'browserRequirements' for consistency with 'carrierRequirements'.
+</p>
 
 <ul>
 <li>Add a new type, 'SoftwareApplication', whose super-type is CreativeWork. Properties:
@@ -80,8 +82,8 @@
     <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>
+    <li>New property 'applicationCategory', expected type URL or Text, description 'Type of software application. e.g. Game, Multimedia.'</li>
+    <li>New property 'applicationSubCategory', expected type URL or Text, description 'Subcategory of the application "e.g. Arcade Game".'</li>
     <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>
@@ -92,13 +94,11 @@
     <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>	
+      </ul>	
 </li>
 
 <li>Add a new type, 'MobileApplication', whose super-type is the new 'SoftwareApplication' class defined above. Properties:
@@ -113,11 +113,14 @@
   </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>NOTE: Since we are not adding the entire software category enumeration, we should somewhere show exactly how these are 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; the addition of URL here is an expansion of the original proposal.
 </li>
+</ul>
 	
-	
+<h4>Converge URL/Url spelling</h4>
+<ul>	
 <li>Converge *Url/*URL property spelling, per <a href="https://www.w3.org/2011/webschema/track/issues/9">mixed case</a> resolution:
   <ul>
 	<li>For each of embedURL, contentURL, downloadURL, ensure there is an equivalent property named with mixed-case: 'embedUrl', 'contentUrl', 'downloadUrl'.</li>
@@ -143,6 +146,8 @@
 	
 <p>None (as of 2012-04-10)</p>
 	
+	<hr />
 	
+	Editor: Dan Brickley &lt;danbri@danbri.org&gt;
 </body>
 </html>
\ No newline at end of file