W3C home > Mailing lists > Public > public-device-apis@w3.org > August 2009

RE: Editing specifications with ReSpec.js

From: JOSE MANUEL CANTERA FONSECA <jmcf@tid.es>
Date: Thu, 06 Aug 2009 12:58:56 +0200
To: Anselm R Garbe <anselm@aplixcorp.com>, Robin Berjon <robin@robineko.com>
Cc: "public-device-apis@w3.org" <public-device-apis@w3.org>, Marcos Caceres <marcosc@opera.com>
Message-id: <93AA9E47B82F684A868C217766F4890538E64F57DC@EXCLU2K7.hi.inet>
Hi,

I would prefer not to use wiki evil formats. Markup is a better solution 

Best Regards

-----Mensaje original-----
De: public-device-apis-request@w3.org [mailto:public-device-apis-request@w3.org] En nombre de Anselm R Garbe
Enviado el: jueves, 06 de agosto de 2009 12:41
Para: Robin Berjon
CC: public-device-apis@w3.org; Marcos Caceres
Asunto: Re: Editing specifications with ReSpec.js

Hi there,

2009/8/6 Robin Berjon <robin@robineko.com>:
> one of the annoying decisions one has to make when editing a specification
> is which tool to use to generate the final, PubRules compliant HTML.
>
> I don't intend to impose a solution on this — it is up to editors to decide
> collectively — but I would like to suggest my favourite option: ReSpec.js.
>
> Its chief advantage is that it does not require running any external tool,
> one simply edits an HTML document according to some conventions, reloads it
> in the browser, and voilà. It also has built-in support for WebIDL, which'll
> come in handy for us. Unless you hit a bug it should provide you with
> PubRules compliant HTML very easily (the checker complains about a couple
> small things, but I would think that they're wrong).
>
> I won't bend your ear longer than necessary here, you can read more about it
> at:
>
>  http://dev.w3.org/2009/dap/ReSpec.js/documentation.html

>
> and in general poke around http://dev.w3.org/2009/dap/ReSpec.js/ to see what
> it's made of.

Why editing HTML at all? I'd propose to write specs in plain
markdown[1] and add some additional pre- or post-filters to it, in
order to generate PubRules compliant HTML. In contrast to HTML,
markdown aims at being readable in source and gives an idea about
WYSIWYM -- it can be extended with rfc2119 style keywords -- and even
your ReSpec.js could be integrated during the generator run.

Various decent wiki systems like ikiwiki or werc rely on markdown
nowadays as well.

[1] http://daringfireball.net/projects/markdown/


Kind regards,
Anselm

Received on Thursday, 6 August 2009 10:59:40 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Wednesday, 9 May 2012 00:13:59 GMT