W3C home > Mailing lists > Public > www-archive@w3.org > December 2009

Re: Proposed W3C Spec Conventions

From: Doug Schepers <schepers@w3.org>
Date: Fri, 04 Dec 2009 13:04:13 -0500
Message-ID: <4B194F1D.5040601@w3.org>
To: spec-prod@w3.org
Hi, Folks-

Thanks for all the great feedback so far!

I've discovered the existing list spec-prod, which seems like a better 
place for these discussions, so I'd ask that anyone interested in 
following up further respond to spec-prod instead of www-archive.

-Doug Schepers
W3C Team Contact, SVG and WebApps WGs

Doug Schepers wrote (on 11/23/09 3:44 AM):
> Hi, Folks-
> (Forwarding and summarizing from Member-only space.)
> I'm not the first one to suggest this (apparently Karl tried to push
> this earlier this year), but I really think it's time we establish some
> standardized style conventions for W3C specs.
> I took a couple hours to pull together a proposal (attached) based on
> Karl's original along with feedback to that proposal, and conventions
> that I'm familiar with from the SVG and DOM3 Events specs; I'm not
> married to any of it, but any counter-proposals should probably stick
> with at least the level of granularity laid out here.
> Please see the attached, and send in counter-proposals or thoughts for
> consideration.
> I plan on using this (or whatever variant we all decide on) in the specs
> I'm editing (some SVG specs, DOM3 Events). I encourage others to do the
> same, and report back what works, what doesn't work, what's missing, etc.
> (Oh, and I'd really like to see this working with Robin Berjon's ReSpec.js:
> http://dev.w3.org/2009/dap/ReSpec.js/documentation.html )
> Thanks!
> -Doug Schepers
> W3C Team Contact, SVG and WebApps \o/ WGs
Received on Friday, 4 December 2009 18:04:15 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 7 January 2015 14:43:37 UTC