Re: Publishing a new WD of Clipboard API and events spec

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