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

Re: respec.js for other kinds of documents

From: Robin Berjon <robin@berjon.com>
Date: Tue, 3 May 2011 15:40:26 +0200
Cc: spec-prod@w3.org
Message-Id: <D5642B37-D7E5-4305-92F9-B8044CDC7935@berjon.com>
To: William Waites <ww@styx.org>
On May 2, 2011, at 12:10 , William Waites wrote:
> Hello, I've been looking at respec.js as part of some work with the
> RDF-WG and also with an eye to using it as a documentation tool for my
> one of own projects. Would a patch be accepted that introduced a new
> specStatus of "other" that basically behaves like "unofficial" except
> that the "Status of This Document" defaults to empty (since the boiler
> plate of being for a potential specification isn't really applicable
> for, e.g. a software manual)?

Yes, that would be perfectly fine. That being said, if you want to handle different types of documents with different requirements you might wish to check out ReSpec v2. The docs are very sparse but 98% of the stuff works just like v1. One big addition though is that everything's a plugin so you can add your own document types as you please (there's an example of doing just that for the "Robineko Reports" document style in the repository).


Robin Berjon - http://berjon.com/
Received on Tuesday, 3 May 2011 13:40:51 UTC

This archive was generated by hypermail 2.3.1 : Tuesday, 6 January 2015 20:42:19 UTC