- From: Arthur Barstow <art.barstow@nokia.com>
- Date: Fri, 28 Feb 2014 09:15:20 -0500
- To: "Hallvord R. M. Steen" <hsteen@mozilla.com>
- CC: Robin Berjon <robin@w3.org>, www-archive@w3.org
On 2/28/14 7:59 AM, ext Hallvord R. M. Steen wrote: > Well, for whatever reason I've ended up using both ReSpec and Anolis, the latter eventually only to add some cross-references which I haven't figured out if/how ReSpec can do. > So yes, it is an "Anolis spec" but only sort of :-p Hallvord - Robin looked at the source code (thanks Robin!) and he reported: [[ Looking at the source, this seems to me that it is 98% a ReSpec document, with a few Anolis things sprinkled on. I haven't pubruled it, but this looks like it would be at least pretty close to being a proper WD: http://dev.w3.org/2006/webapi/clipops/clipops-source.html?specStatus=WD There are essentially two things that would ideally be fixed to make it ship cleanly: • There are a few instances of <hN> elements that aren't in their own <section>. That's bad practice in general, and in the case of ReSpec it causes them not to be numbered and included in the ToC. • At least one of those has a "This section is informative" bit included. That could be removed, and just add class=informative on its parent section. • There are a few cases of data-anolis-spec=html. The best way to fix this is to have a section that says: <p>The following items are defined in the HTML specification. [[!HTML5]]</p> <ul> <li><dfn><a href='link to #feature'>foo</a></dfn></li> ... </ul> and then for each instance, instead of <code data-anolis-spec='html'>foo</code> just use <a>foo</a>. There's an example of the same in: http://darobin.github.io/formic/specs/json/ I *think* that should be enough. ]] Based on Robin's info, it seems like the "right/best" way forward (in the long term) is to remove all of anolis and make it 100% ReSpec, although that would not necessarily need to be done before a new version of a WD is created. In the short-term, perhaps the URL Robin gives above could be expanded a bit to create a draft WD: <http://dev.w3.org/2006/webapi/clipops/clipops-source.html?specStatus=WD;publishDate=2014-03-06;previousPublishDate=2013-04-11> And a Ctrl+Alt+Shift+S saved version of that could then be updated per the validators (<https://www.w3.org/wiki/Webapps/SpecEditing>) to create the WD for publishing. WDYT? -Thanks, Art
Received on Friday, 28 February 2014 14:20:15 UTC