ReSpec.js

A Fresh Specification-Writing Tool

Robin Berjon

Vodafone

Why a new spec-writing tool?

Really, man, why?

What's good about it?

it's my baby

Ashley

How a web developer creates a document

or "How sausages are made"

Lifecycle

How most spec-writing tools work

Too much information about sausages

Lifecycle

How ReSpec.js approaches this issue

Make Your Editors 33% more efficient!!!!!1

Lifecycle

How does it work?

all pretty on the inside

But, so, what does it do?

Simple configuration generates oodles of HTML

I love the word "oodles"

          var respecConfig = {
              specStatus:           "RSCND",
              shortName:            "sexy-spec",
              previousPublishDate:  "1977-03-15",
              previousMaturity:  "REC",
              edDraftURI:           "http://dev.w3.org/2006/waf/widget-access/",
              extraCSS:             ["../../../2009/dap/ReSpec.js/css/respec.css"],
              editors:  [
                  { name: "Robin Berjon", url: "http://berjon.com/",
                    company: "Vodafone", companyURL: "http://vodafone.com/" },
              ],
              wg:           "Best Ever WG",
              wgURI:        "http://www.w3.org/dated/uris/are/evil/",
              wgPublicList: "public-coolness",
              wgPatentURI:  "http://www.w3.org/2004/01/pp-impl/42/status",
          };
        

Pretty much writes the spec for you

Less boilerplate, more time for beer

Rscnd

Sections and ToC

structured so you don't have to be

RFC 2119 is not OPTIONAL

the next version has EXTERMINATE

References

Pointing fingers

Nice Little Extras

Sugar and Unicorns

WebIDL Support

for thems API geeks

interface Unicorn: Cryptid, Mammal {
    Dahut convertToDahut(in boolean chirality) raises IsInvisibleException;
}
        

WebIDL Support (bis)

it's addictive

But then you start wanting more...

Limitations

just to pretend I'm unbiased

Ongoing & Future Work

more magic, more of the time

Where to get it

sorry about the dated URI

Where it's used

satisfied customers

Thanks!