W3C home > Mailing lists > Public > spec-prod@w3.org > April to June 2012

Questions upon converting to ReSpec2

From: Dan Burnett <dburnett@voxeo.com>
Date: Thu, 17 May 2012 09:07:23 -0400
Message-Id: <23BF38C6-DD09-4B7E-8237-C1AFFF24C0E9@voxeo.com>
To: spec-prod@w3.org
Hi.  We've been using ReSpec.js for our specification draft and would like to convert to using ReSpec2.  I took the webrtc.html file in the attached zip file, changed the link to ReSpec.js to point to a local copy of ReSpec2 (downloaded from http://dvcs.w3.org/hg/respec2), and noted the differences.

I have reviewed the official html docs, but I can't seem to find a way to correct for the crucial differences below.  Can anyone suggest what parameters I need to set or help me understand what changes I need to make to fix these?


- Previous version link is missing (specified as  previousURI: "http://dev.w3.org/2011/webrtc/editor/webrtc-20120112.html")

- Custom copyright line is missing (specified as  overrideCopyright: ((our text here)) )

- SOTD has the inappropriate sentence "The group does not expect this document to become a W3C Recommendation." inserted!  Is this because the document is an ED?  If so, why the change?  It's clear that it's an editor's draft anyway without this sentence.

- There seems to be no WebIDL Dictionary support -- all IDL, document sections, and corresponding ToC entries are missing.

- in WebIDL, the Constructor parameters seem to be missing 

- in WebIDL, array type attribute now has [] added in the description, which looks weird:  "remoteStreams of type array of MediaStream[]".  It makes it look like it's an array of an array, which it isn't.




Also, I could not figure out how to reference ReSpec2 via a URI as with ReSpec.js, so I had to download and use a local copy.  This is likely because I am unfamiliar with Mercurial.  Does anyone know if there is a way to reference the official version of ReSpec2 via a simple URI?

-- Dan Burnett, Editor in the WebRTC WG




Received on Thursday, 17 May 2012 13:07:55 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 17 May 2012 13:07:56 GMT