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

Guidance on editing specs...

From: Charles McCathieNevile <chaals@opera.com>
Date: Thu, 24 May 2012 12:57:24 +0200
To: "spec-prod@w3.org" <spec-prod@w3.org>
Cc: "Anne van Kesteren" <annevk@opera.com>, "Robin Berjon" <robin@berjon.com>
Message-ID: <op.wes7dyn4wxe0ny@widsith-3.local>
Hi,

a few things have been mentioned on the webapps list recently that are  
really relevant to this list. Although I am not sure who is on this list.

ReSpec and Anolis are processing tools that people use to ease the task of  
editing.
ReSpec is in javascript, Anolis is a set of python stuff.

(Having worked with Anolis I still prefer working on static documents, but  
each to their own - both of these tools have their adherents who are very  
pleased, and both can be modified).

There is also
http://wiki.whatwg.org/wiki/Howto_spec which describes some conventions  
that are currently used for some key specs like HTML5 and DOM4) and
http://scriptlib-cg.github.com/api-design-cookbook/ which gives tricks and  
tips for how to design the architecture of an API.

Is this list alive? Is this really relevant content, or is the list only  
for people who are using an XML chain? Is this stuff documented somewhere  
that should be upated?

cheers

Chaals

-- 
Charles 'chaals' McCathieNevile  Opera Software, Standards Group
     je parle français -- hablo español -- jeg kan noen norsk
http://my.opera.com/chaals       Try Opera: http://www.opera.com
Received on Thursday, 24 May 2012 10:58:10 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 24 May 2012 10:58:11 GMT