Re: Proposed W3C Spec Conventions

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.

Regards-
-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