Added submission information to report template and re-generated report.
authorGregg Kellogg <gregg@kellogg-assoc.com>
Wed, 27 Feb 2013 09:45:52 -0800
changeset 611 1efbfb138178
parent 610 d6654f654a68
child 612 40f56f0618fc
Added submission information to report template and re-generated report.
rdf-turtle/reports/index.html
rdf-turtle/reports/template.html
--- a/rdf-turtle/reports/index.html	Tue Feb 26 13:57:39 2013 -0800
+++ b/rdf-turtle/reports/index.html	Wed Feb 27 09:45:52 2013 -0800
@@ -4,7 +4,7 @@
     <meta content='text/html;charset=utf-8' http-equiv='Content-Type' />
     <title>
       Turtle
-      Conformance Report
+      Implementation Report
     </title>
     <script class='remove' src='http://www.w3.org/Tools/respec/respec-w3c-common' type='text/javascript'></script>
     <script type='text/javascript'>
@@ -13,6 +13,7 @@
         // extend the bibliography entries
         localBiblio: {
             TURTLE: "Eric Prud'hommeaux, Gavin Carothers. <cite><a href=\"http://www.w3.org/TR/2013/CR-turtle-20130219/\">Turtle: Terse RDF Triple Language.</a></cite> W3C Candidate Recommendation 19 February 2013. URL: <a href=\"http://www.w3.org/TR/2013/CR-turtle-20130219/\">http://www.w3.org/TR/2013/CR-turtle-20130219/</a>",
+            DOAP: "Ed Dumbill. <cite><a href=\"https://github.com/edumbill/doap/wiki\">Turtle: Terse RDF Triple Language.</a></cite> Community Specification. URL: <a href=\"https://github.com/edumbill/doap/wiki\">https://github.com/edumbill/doap/wiki</a>",
         },
     
         // specification status (e.g. WD, LCWD, NOTE, etc.). If in doubt use ED.
@@ -22,9 +23,9 @@
     
         // the specification's short name, as in http://www.w3.org/TR/short-name/
         shortName:            "turtle-earl",
-        subtitle:             "Turtle Implementation Conformance Report",
+        //subtitle:             "Turtle Implementation Conformance Report",
         // if you wish the publication date to be other than today, set this
-        publishDate:  "2013/02/26",
+        publishDate:  "2013/02/27",
     
         // if there is a previously published draft, uncomment this and set its YYYY-MM-DD date
         // and its maturity status
@@ -139,6 +140,35 @@
     </section>
     <section id='sodt'></section>
     <section>
+      <h2>Instructions for submitting implementation reports</h2>
+      
+      <p>Tests should be run using the test manifests defined in the 
+        <a href="#test-manifests">Test Manifests</a> Section.</p>
+      
+      <p>The assumed base URI for the tests is <code>&lt;http://example/base/&gt;</code> if needed.</p>
+      
+      <p>Reports should be submitted in Turtle format to <a href="public-rdf-comments@w3.org">public-rdf-comments@w3.org</a>
+        and include an <code>earl:Assertion</code>
+        for each test, referencing the test resource from the associated manifest
+        and the test subject being reported upon. An example test entry is be the following:</p>
+      
+      <pre><code>  [ a earl:Assertion;&#x000A;    earl:assertedBy &lt;http://greggkellogg.net/foaf#me&gt;;&#x000A;    earl:subject &lt;http://rubygems.org/gems/rdf-turtle&gt;;&#x000A;    earl:test &lt;https://dvcs.w3.org/hg/rdf/raw-file/default/rdf-turtle/tests-ttl/manifest.ttl#turtle-syntax-file-01&gt;;&#x000A;    earl:result [&#x000A;      a earl:TestResult;&#x000A;      earl:outcome earl:passed;&#x000A;      dc:date &quot;2013-02-22T15:12:30-08:00&quot;^^xsd:dateTime];&#x000A;    earl:mode earl:automatic ] .&#x000A;</code></pre>
+      
+      <p>The Test Subject should be defined as a <code>doap:Project</code>, including the name,
+        homepage and developer(s) of the software (see [[DOAP]]). Optionally, including the
+        project description and programming language. An example test subject description is the following:</p>
+      
+      <pre><code>  &lt;http://rubygems.org/gems/rdf-turtle&gt; a doap:Project, earl:TestSubject, earl:Software ;&#x000A;    doap:name          &quot;RDF::Turtle&quot; ;&#x000A;    doap:homepage      &lt;http://ruby-rdf.github.com/rdf-turtle&gt; ;&#x000A;    doap:license       &lt;http://creativecommons.org/licenses/publicdomain/&gt; ;&#x000A;    doap:description   &quot;RDF::Turtle is an Turtle reader/writer for the RDF.rb library suite.&quot;@en ;&#x000A;    doap:created       &quot;2011-08-29&quot;^^xsd:date ;&#x000A;    doap:programming-language &quot;Ruby&quot; ;&#x000A;    doap:implements    &lt;http://www.w3.org/TR/turtle/&gt; ;&#x000A;    doap:category      &lt;http://dbpedia.org/resource/Resource_Description_Framework&gt;,&#x000A;                       &lt;http://dbpedia.org/resource/Ruby_(programming_language)&gt; ;&#x000A;    doap:download-page &lt;http://rubygems.org/gems/rdf-turtle&gt; ;&#x000A;    doap:mailing-list  &lt;http://lists.w3.org/Archives/Public/public-rdf-ruby/&gt; ;&#x000A;    doap:bug-database  &lt;http://github.com/ruby-rdf/rdf-turtle/issues&gt; ;&#x000A;    doap:blog          &lt;http://greggkellogg.net/&gt; ;&#x000A;    doap:developer     &lt;http://greggkellogg.net/foaf#me&gt; ;&#x000A;    doap:maintainer    &lt;http://greggkellogg.net/foaf#me&gt; ;&#x000A;    doap:documenter    &lt;http://greggkellogg.net/foaf#me&gt; ;&#x000A;    foaf:maker         &lt;http://greggkellogg.net/foaf#me&gt; ;&#x000A;    dc:title           &quot;RDF::Turtle&quot; ;&#x000A;    dc:description     &quot;RDF::Turtle is an Turtle reader/writer for the RDF.rb library suite.&quot;@en ;&#x000A;    dc:date            &quot;2011-08-29&quot;^^xsd:date ;&#x000A;    dc:creator         &lt;http://greggkellogg.net/foaf#me&gt; ;&#x000A;</code></pre>
+      
+      <p>The software developer, either an organization or one or more individuals SHOULD be
+        referenced from <code>doap:developer</code> using [[FOAF]]. For example:</p>
+      
+      <pre><code>  &lt;http://greggkellogg.net/foaf#me&gt; a foaf:Person, earl:Assertor;&#x000A;    foaf:name &quot;Gregg Kellogg&quot;;&#x000A;    foaf:title &quot;Implementor&quot;;&#x000A;    foaf:homepage &lt;http://greggkellogg.net/&gt; .&#x000A;</code></pre>
+      
+      <p>See <a href="http://www.w3.org/2011/rdf-wg/wiki/Turtle_Test_Suite">Turtle Test Suite Wiki</a>
+        for more information.</p>
+    </section>
+    <section>
       <h2>
         Test Manifests
       </h2>
--- a/rdf-turtle/reports/template.html	Tue Feb 26 13:57:39 2013 -0800
+++ b/rdf-turtle/reports/template.html	Wed Feb 27 09:45:52 2013 -0800
@@ -47,13 +47,14 @@
     %meta{"http-equiv" => "Content-Type", :content => "text/html;charset=utf-8"}
     %title
       = tests['name']
-      Conformance Report
+      Implementation Report
     %script.remove{:type => "text/javascript", :src => "http://www.w3.org/Tools/respec/respec-w3c-common"}
     :javascript
       var respecConfig = {
           // extend the bibliography entries
           localBiblio: {
               TURTLE: "Eric Prud'hommeaux, Gavin Carothers. <cite><a href=\"http://www.w3.org/TR/2013/CR-turtle-20130219/\">Turtle: Terse RDF Triple Language.</a></cite> W3C Candidate Recommendation 19 February 2013. URL: <a href=\"http://www.w3.org/TR/2013/CR-turtle-20130219/\">http://www.w3.org/TR/2013/CR-turtle-20130219/</a>",
+              DOAP: "Ed Dumbill. <cite><a href=\"https://github.com/edumbill/doap/wiki\">Turtle: Terse RDF Triple Language.</a></cite> Community Specification. URL: <a href=\"https://github.com/edumbill/doap/wiki\">https://github.com/edumbill/doap/wiki</a>",
           },
 
           // specification status (e.g. WD, LCWD, NOTE, etc.). If in doubt use ED.
@@ -63,7 +64,7 @@
 
           // the specification's short name, as in http://www.w3.org/TR/short-name/
           shortName:            "turtle-earl",
-          subtitle:             "Turtle Implementation Conformance Report",
+          //subtitle:             "Turtle Implementation Conformance Report",
           // if you wish the publication date to be other than today, set this
           publishDate:  "#{Time.now.strftime("%Y/%m/%d")}",
 
@@ -170,6 +171,67 @@
           JSON-LD
     %section#sodt
     %section
+      :markdown
+        ## Instructions for submitting implementation reports
+
+          Tests should be run using the test manifests defined in the 
+          [Test Manifests](#test-manifests) Section.
+
+          The assumed base URI for the tests is `<http://example/base/>` if needed.
+
+          Reports should be submitted in Turtle format to [public-rdf-comments@w3.org](public-rdf-comments@w3.org)
+          and include an `earl:Assertion`
+          for each test, referencing the test resource from the associated manifest
+          and the test subject being reported upon. An example test entry is be the following:
+
+              [ a earl:Assertion;
+                earl:assertedBy <http://greggkellogg.net/foaf#me>;
+                earl:subject <http://rubygems.org/gems/rdf-turtle>;
+                earl:test <https://dvcs.w3.org/hg/rdf/raw-file/default/rdf-turtle/tests-ttl/manifest.ttl#turtle-syntax-file-01>;
+                earl:result [
+                  a earl:TestResult;
+                  earl:outcome earl:passed;
+                  dc:date "2013-02-22T15:12:30-08:00"^^xsd:dateTime];
+                earl:mode earl:automatic ] .
+
+          The Test Subject should be defined as a `doap:Project`, including the name,
+          homepage and developer(s) of the software (see [[DOAP]]). Optionally, including the
+          project description and programming language. An example test subject description is the following:
+
+              <http://rubygems.org/gems/rdf-turtle> a doap:Project, earl:TestSubject, earl:Software ;
+                doap:name          "RDF::Turtle" ;
+                doap:homepage      <http://ruby-rdf.github.com/rdf-turtle> ;
+                doap:license       <http://creativecommons.org/licenses/publicdomain/> ;
+                doap:description   "RDF::Turtle is an Turtle reader/writer for the RDF.rb library suite."@en ;
+                doap:created       "2011-08-29"^^xsd:date ;
+                doap:programming-language "Ruby" ;
+                doap:implements    <http://www.w3.org/TR/turtle/> ;
+                doap:category      <http://dbpedia.org/resource/Resource_Description_Framework>,
+                                   <http://dbpedia.org/resource/Ruby_(programming_language)> ;
+                doap:download-page <http://rubygems.org/gems/rdf-turtle> ;
+                doap:mailing-list  <http://lists.w3.org/Archives/Public/public-rdf-ruby/> ;
+                doap:bug-database  <http://github.com/ruby-rdf/rdf-turtle/issues> ;
+                doap:blog          <http://greggkellogg.net/> ;
+                doap:developer     <http://greggkellogg.net/foaf#me> ;
+                doap:maintainer    <http://greggkellogg.net/foaf#me> ;
+                doap:documenter    <http://greggkellogg.net/foaf#me> ;
+                foaf:maker         <http://greggkellogg.net/foaf#me> ;
+                dc:title           "RDF::Turtle" ;
+                dc:description     "RDF::Turtle is an Turtle reader/writer for the RDF.rb library suite."@en ;
+                dc:date            "2011-08-29"^^xsd:date ;
+                dc:creator         <http://greggkellogg.net/foaf#me> ;
+
+          The software developer, either an organization or one or more individuals SHOULD be
+          referenced from `doap:developer` using [[FOAF]]. For example:
+
+              <http://greggkellogg.net/foaf#me> a foaf:Person, earl:Assertor;
+                foaf:name "Gregg Kellogg";
+                foaf:title "Implementor";
+                foaf:homepage <http://greggkellogg.net/> .
+
+          See [Turtle Test Suite Wiki](http://www.w3.org/2011/rdf-wg/wiki/Turtle_Test_Suite)
+          for more information.
+    %section
       - test_info = {}
       - test_refs = {}
       - subject_refs = {}