NEW DRAFT: HTML5-warnings - now with consistent warnings

I have updated the HTML5-warnings draft that I intend to publish (if the
poll deems that it should be published) by applying Maciej's 3
consistency rules along with one additional criteria (for external spec
violations). The set of consistency rules can be found in this e-mail:

http://lists.w3.org/Archives/Public/public-html/2009Aug/0550.html

This has resulted in a consistent set of warnings, based on applying the
set of rules outlined above. Each warning can be traced to an unresolved
tracker issue that is more than 4 months old, a perma-thread
conversation (more than 100 messages long) that is more than 4 months
old, or is a clear violation of another Internet standard:

http://html5.digitalbazaar.com/specs/html5-warnings-draft2-diff.html#editor-s-draft-date-14-August-2009
http://html5.digitalbazaar.com/specs/html5-warnings-draft2-diff.html#urls
http://html5.digitalbazaar.com/specs/html5-warnings-draft2-diff.html#fetch
http://html5.digitalbazaar.com/specs/html5-warnings-draft2-diff.html#misinterpreted-for-compatibility
http://html5.digitalbazaar.com/specs/html5-warnings-draft2-diff.html#navigating-across-documents
http://html5.digitalbazaar.com/specs/html5-warnings-draft2-diff.html#microdata
http://html5.digitalbazaar.com/specs/html5-warnings-draft2-diff.html#obsolete
http://html5.digitalbazaar.com/specs/html5-warnings-draft2-diff.html#the-source-element
http://html5.digitalbazaar.com/specs/html5-warnings-draft2-diff.html#alt
http://html5.digitalbazaar.com/specs/html5-warnings-draft2-diff.html#the-head-element

There were a number of accidental technical changes to the previous
document that are now corrected:

* Removed Web Workers section
* Removed Client-side storage section
* Removed Server sent events section
* Removed Web Sockets section

Emotionally charged language has been re-worded to be less emotionally
charged and more accurate:

* All language mentioning "controversial" sections has been changed to
  sections "under active discussion".
* The mis-representation of the @alt issue has been corrected.
* The inaccurate representation of Barth IETF draft has been corrected
  using Julian's language.

By applying the consistency rules to the set of previous warnings, the
following warnings have been removed [with the reason they were removed
in square brackets], and the URL demonstrating that the warning is no
longer included below:

* Metadata registry at WHAT WG [No ISSUE in tracker]
http://html5.digitalbazaar.com/specs/html5-warnings-draft2-diff.html#other-metadata-names

* The elements of HTML section warning - hgroup, nav, article
  [No ISSUE in tracker]
http://html5.digitalbazaar.com/specs/html5-warnings-draft2-diff.html#sections

* The BB element [No ISSUE in tracker]
http://html5.digitalbazaar.com/specs/html5-warnings-draft2-diff.html#the-bb-element

* Garbage collection [No ISSUE in tracker]
http://html5.digitalbazaar.com/specs/html5-warnings-draft2-diff.html#implied-strong-reference

* Pre-defined vocabularies [No ISSUE in tracker]
http://html5.digitalbazaar.com/specs/html5-warnings-draft2-diff.html#predefined-type

As promised, I focused on removing warnings, not adding them. The next
heartbeat WD will contain all warnings that meet the consistent warning
criteria listed above.

I intend to open each one of the items above as a tracker ISSUE if there
aren't many objections to doing so in the next week. The plan is to
integrate tracker issues warnings (that are at least 4 months old) into
the W3C WD specs (via a <div> overlay) that are published henceforth.

There were a number of voting members that have expressed that making
these changes would address their concerns regarding the publishing of
the HTML5-warnings draft. If these changes address your concerns, please
note your agreement by updating your poll responses:

http://www.w3.org/2002/09/wbs/40318/wd08/

-- manu

-- 
Manu Sporny (skype: msporny, twitter: manusporny)
President/CEO - Digital Bazaar, Inc.
blog: Bitmunk 3.1 Released - Browser-based P2P Commerce
http://blog.digitalbazaar.com/2009/06/29/browser-based-p2p-commerce/

Received on Friday, 14 August 2009 05:16:11 UTC