Updated after IRC meeting with Stephane Corlosquet, addressing the issues collected in http://lists.w3.org/Archives/Public/public-vocabs/2014Jan/0200.html
authordanbri <danbri@google.com>
Thu, 06 Feb 2014 18:43:51 +0100
changeset 172 eb9d44971328
parent 171 cb75cd931729
child 175 861b6fd28fcb
Updated after IRC meeting with Stephane Corlosquet, addressing the issues collected in http://lists.w3.org/Archives/Public/public-vocabs/2014Jan/0200.html
schema.org/ext/QA.html
--- a/schema.org/ext/QA.html	Thu Feb 06 18:10:12 2014 +0100
+++ b/schema.org/ext/QA.html	Thu Feb 06 18:43:51 2014 +0100
@@ -14,14 +14,15 @@
     </style>
   </head>
   <body>
-    <h1>Questions and answers extension for schema.org</h1>
-    <p>Enrichment of Schema.org to enable annotation of questions and answers type of content.</p>
+    <h1>Question and answers extension for schema.org</h1>
+    <p>Enrichment of Schema.org to enable annotation of question and answer content, as <a href="http://lists.w3.org/Archives/Public/public-vocabs/2014Jan/0200.html">discussed</a> 
+on public-vocabs@w3.org.</p>
     <p>See <a href="http://www.w3.org/wiki/WebSchemas/QASchemaResearch">wiki</a> for details.</p>
 
     <!--  New QAPage class. -->
     <div typeof="rdfs:Class" resource="http://schema.org/QAPage">
       <span class="h" property="rdfs:label">QAPage</span>
-      <span property="rdfs:comment">A QAPage is a WebPage focussed on a specific Question and its Answer(s).</span>
+      <span property="rdfs:comment">A QAPage is a WebPage focussed on a specific Question and its Answer(s), e.g. in a question answering site or documenting Frequently Asked Questions (FAQs).</span>
       <span>Subclass of: <a property="rdfs:subClassOf" href="http://schema.org/WebPage">WebPage</a></span>
     </div>
 
@@ -33,13 +34,13 @@
     <!--  New Question class. -->
     <div typeof="rdfs:Class" resource="http://schema.org/Question">
       <span class="h" property="rdfs:label">Question</span>
-      <span property="rdfs:comment">A detailed question that a user is seeking an answer from a community of experts.</span>
+      <span property="rdfs:comment">A specific question - e.g. from a user seeking answers online, or collected in a Frequently Asked Questions (FAQ) document.</a>
       <span>Subclass of: <a property="rdfs:subClassOf" href="http://schema.org/CreativeWork">CreativeWork</a></span>
     </div>
     <!--  New properties for the new Question class. -->
     <div typeof="rdf:Property" resource="http://schema.org/upvoteCount">
       <span class="h" property="rdfs:label">upvoteCount</span>
-      <span property="rdfs:comment">The number of upvotes this questions has received from the community.</span>
+      <span property="rdfs:comment">The number of upvotes this question has received from the community.</span>
       <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/Question">Question</a></span>
       <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/Answer">Answer</a></span>
       <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/Comment">Comment</a></span>
@@ -47,18 +48,23 @@
     </div>
     <div typeof="rdf:Property" resource="http://schema.org/downvoteCount">
       <span class="h" property="rdfs:label">downvoteCount</span>
-      <span property="rdfs:comment">The number of downvotes this questions has received from the community.</span>
+      <span property="rdfs:comment">The number of downvotes this question has received from the community.</span>
       <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/Question">Question</a></span>
       <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/Answer">Answer</a></span>
       <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/Comment">Comment</a></span>
       <span>Range: <a property="http://schema.org/range" href="http://schema.org/Integer">Integer</a></span>
     </div>
+
+<!-- dropping for now, per http://lists.w3.org/Archives/Public/public-vocabs/2014Jan/0200.html
     <div typeof="rdf:Property" resource="http://schema.org/viewCount">
       <span class="h" property="rdfs:label">viewCount</span>
-      <span property="rdfs:comment">The number of times this questions has viewed.</span>
+      <span property="rdfs:comment">The number of times this question has viewed.</span>
       <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/Question">Question</a></span>
       <span>Range: <a property="http://schema.org/range" href="http://schema.org/Integer">Integer</a></span>
     </div>
+-->
+
+<!-- dropping lastEditor, at least for now. 
     <div typeof="rdf:Property" resource="http://schema.org/lastEditor">
       <span class="h" property="rdfs:label">lastEditor</span>
       <span property="rdfs:comment">The user who last edited this question or answer.</span>
@@ -66,6 +72,8 @@
       <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/Answer">Answer</a></span>
       <span>Range: <a property="http://schema.org/range" href="http://schema.org/Person">Person</a></span>
     </div>
+--> 
+
     <div typeof="rdf:Property" resource="http://schema.org/answerCount">
       <span class="h" property="rdfs:label">answerCount</span>
       <span property="rdfs:comment">The number of answers this question has received.</span>
@@ -74,14 +82,14 @@
     </div>
     <div typeof="rdf:Property" resource="http://schema.org/commentCount">
       <span class="h" property="rdfs:label">commentCount</span>
-      <span property="rdfs:comment">The number of comments this question or answer has received.</span>
-      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/Question">Question</a></span>
-      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/Answer">Answer</a></span>
+      <span property="rdfs:comment">The number of comments this CreativeWork (e.g. Article, Question or Answer) has received. This is most applicable to works published in Web sites with commenting system; additional comments may exist elsewhere.</span>
+      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/CreativeWork">CreativeWork</a></span>
       <span>Range: <a property="http://schema.org/range" href="http://schema.org/Integer">Integer</a></span>
     </div>
+
     <div typeof="rdf:Property" resource="http://schema.org/acceptedAnswer">
       <span class="h" property="rdfs:label">acceptedAnswer</span>
-      <span property="rdfs:comment">The answer the owner of the original question has accepted as best answer.</span>
+      <span property="rdfs:comment">"The answer that has been accepted as best, typically on a Question/Answer site. Sites vary in their selection mechanisms, e.g. drawing on community opinion and/or the view of the Question author.</span>
       <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/Question">Question</a></span>
       <span>Range: <a property="http://schema.org/range" href="http://schema.org/Answer">Answer</a></span>
     </div>
@@ -89,7 +97,7 @@
     <!--  New Answer class. -->
     <div typeof="rdfs:Class" resource="http://schema.org/Answer">
       <span class="h" property="rdfs:label">Answer</span>
-      <span property="rdfs:comment">An answer to a question.</span>
+      <span property="rdfs:comment">An answer offered to a question; perhaps correct, perhaps opinionated or wrong.</span>
       <span>Subclass of: <a property="rdfs:subClassOf" href="http://schema.org/CreativeWork">CreativeWork</a></span>
     </div>
     <!--  New properties for the new Answer class. -->
@@ -101,7 +109,22 @@
       <span>Range: <a property="http://schema.org/range" href="http://schema.org/Question">Question</a></span>
     </div>
 
-    <hr />
+
+
+   <!-- associations -->
+
+<div typeof="rdf:Property" resource="http://schema.org/suggestedAnswer">
+ <span class="h" property="rdfs:label">suggestedAnswer</span>
+ <span property="rdfs:comment">An answer (possibly one of several, possibly incorrect) to a Question, e.g. on a Question/Answer site, often collected in a QAWebPage.</span>
+ <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/Question">Question</a></span>
+ <span>Range: <a property="http://schema.org/range" href="http://schema.org/Answer">Answer</a></span>
+ <link property="rdfs:subPropertyOf" href="http://schema.org/answer" />
+</div>
+
+
+ <hr />
+
+
 
 
   </body>