normative-references-conformance.html 14.5 KB
<?xml version="1.0"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
  <head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    <style type="text/css" media="all">
    @import "/QA/2006/01/blogstyle.css";
    </style>
    <meta name="keywords" content='conformance, qa, quality, specification, tpac, tpac2008, working group' />
    <meta name="description" content="When creating a requirement in a specification should I link to it or should I include it. The answer depends on the context." />
    <meta name="revision" content="$Id: normative-references-conformance.html,v 1.41 2011/12/16 03:03:05 gerald Exp $" />    
   <link rel="alternate" type="application/atom+xml" title="Atom" href="http://www.w3.org/QA/atom.xml" />
   <link rel="alternate" type="application/rss+xml" title="RSS 1.0" href="http://www.w3.org/QA/news.rss" />   
   <title>Normative References to Moving Targets are Dangerous - W3C Blog</title>

   <link rel="start" href="http://www.w3.org/QA/" title="Home" />
   <link rel="prev" href="http://www.w3.org/QA/2008/10/w3c-chairs-tshirt.html" title="W3C Chairs T-Shirt" />
   <link rel="next" href="http://www.w3.org/QA/2008/10/tpac2008-listen_discuss.html" title="W3C TPAC 2008 - Listen, Read, Discuss" />

   <!--
<rdf:RDF xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
         xmlns:trackback="http://madskills.com/public/xml/rss/module/trackback/"
         xmlns:dc="http://purl.org/dc/elements/1.1/">
<rdf:Description
    rdf:about="http://www.w3.org/QA/2008/10/normative-references-conformance.html"
    trackback:ping="http://www.w3.org/QA/sununga/mt-tb.cgi/230"
    dc:title="Normative References to Moving Targets are Dangerous"
    dc:identifier="http://www.w3.org/QA/2008/10/normative-references-conformance.html"
    dc:subject="Technology 101"
    dc:description="When creating a requirement in a specification should I link to it or should I include it. The answer depends on the context."
    dc:creator="Karl Dubost"
    dc:date="2008-10-20T14:22:10+00:00" />
</rdf:RDF>
-->

    <!-- <script type="text/javascript" src="http://www.w3.org/QA/mt.js"></script>-->

</head>
<body class="layout-one-column">
      <div id="banner">
      <h1 id="title">
	<a href="http://www.w3.org/"><img height="48" alt="W3C" id="logo" src="http://www.w3.org/Icons/WWW/w3c_home_nb" /></a>
W3C Blog
</h1>
    </div>
    
    <ul class="navbar" id="menu">
        <li><strong><a href="/QA/" title="W3C Blog Home">[ W3C Blog ]</a></strong></li>
        <li><a href="/QA/Library/" title="Documents and Publications on Web and Quality">Documents</a></li>
        <li><a href="/QA/Tools/" accesskey="3" title="Validators and other Tools">Tools</a></li>
        <li><a href="/2007/12/qa-blog-help/index#feedback">Feedback</a></li>
    </ul>
<div id="searchbox">
<form method="get" action="http://www.google.com/custom" enctype="application/x-www-form-urlencoded">
<p id="formbox"><input type="text" size="15" class="textfield" name="q" accesskey="E" maxlength="255" /> <input type="submit" class="submitfield" value="Search" id="goButton" name="sa" accesskey="G" /> <input type="hidden" name="cof" value="T:black;LW:72;ALC:#ff3300;L:http://www.w3.org/Icons/w3c_home;LC:#000099;LH:48;BGC:white;AH:left;VLC:#660066;GL:0;AWFID:0b9847e42caf283e;" /><input type="hidden" id="searchW3C" name="sitesearch" checked="checked" value="www.w3.org/QA" /><input type="hidden" name="domains" value="www.w3.org/QA" /></p>
</form>
</div>


    <div id="main"><!-- This DIV encapsulates everything in this page - necessary for the positioning -->

                     <p class="content-nav">
                        <a href="http://www.w3.org/QA/2008/10/w3c-chairs-tshirt.html">&laquo; W3C Chairs T-Shirt</a> |
                        <a href="http://www.w3.org/QA/">Main</a>
                        | <a href="http://www.w3.org/QA/2008/10/tpac2008-listen_discuss.html">W3C TPAC 2008 - Listen, Read, Discuss &raquo;</a>
                     </p>

                        <h2 class="entry-header">Normative References to Moving Targets are Dangerous</h2>
                           <div class="entry-body">
                              <p>The work of W3C is sometimes a bit opaque. It is not obvious to people outside of the Working Group. You often only read the end result, a Working Draft, even sometimes the specification.</p>

<p>Yesterday in the WebApps (Web Applications) Working Groups, a discussion has started about a <strong>normative reference from XMLHttpRequest to HTML 5</strong>. <a href="http://www.w3.org/TR/XMLHttpRequest/" title="The XMLHttpRequest Object">XMLHttpRequest</a> is the technology used in AJAX applications on the Web. XMLHttpRequest is more mature and in the final stages for going to last call and hopefully in a few months a W3C Recommendation. <a href="http://www.w3.org/TR/html5/" title="HTML 5">HTML 5</a> is still in high development and not stable at all. There is still work to do on it. Two options were proposed:</p>

<ul>
<li>Should the normative requirement in XMLHttpRequest <strong>be a reference</strong> to the specific prose in HTML 5?</li>
<li>Should the normative requirement in XMLHttpRequest <strong>be included in the prose</strong> of XMLHttpRequest?</li>
</ul>

<p>There is no formal Process requirement on this, because it is highly dependent on the type of the technology and its level of maturity. The <a href="http://www.w3.org/Consortium/Process/" title="World Wide Web Consortium Process Document">W3C Process Document</a> is here to help and be flexible to many use cases, and not be a hurdle. There is an internal W3C Technical Report publication processes. When a document is <a href="http://www.w3.org/2005/08/online_xslt/xslt?xmlfile=http://www.w3.org/2005/08/01-transitions.html&amp;xslfile=http://www.w3.org/2005/08/transitions.xsl&amp;docstatus=pr-tr" title="How to Organize a Recommendation Track Transition">moving to Proposed Recommendation</a>, it has to satisfy all exit criterias of Candidate Recommendation. In this document, we can read </p>

<blockquote>
  <p>Evidence that dependencies with other groups met (or not)</p>
  <li>Does this specification have any normative references to W3C specifications that are not yet Proposed Recommendations? Note: In general, documents do not advance to Recommendation with normative references to W3C specifications that are not yet Recommendations.</li>
  <li>Is there evidence that additional dependencies related to implementation have been satisfied?</li>
</blockquote>

<p>What does it simply mean? <strong>Normative references to moving targets are dangerous</strong>.</p>

                           </div>
                           <div id="more" class="entry-more">
                              

                           </div>
                       <p class="postinfo">Filed by <a href="http://www.w3.org/People/karl/">Karl Dubost</a> on October 20, 2008  2:22 PM in <a href="http://www.w3.org/QA/archive/w3cqa_news/technology_101/">Technology 101</a>, <a href="http://www.w3.org/QA/archive/w3cqa_news/w3c_life/">W3C Life</a><br />
<span class="separator">|</span> <a class="permalink" href="http://www.w3.org/QA/2008/10/normative-references-conformance.html">Permalink</a>
                                 | <a href="http://www.w3.org/QA/2008/10/normative-references-conformance.html#comments">Comments (3)</a>
                                 | <a href="http://www.w3.org/QA/2008/10/normative-references-conformance.html#trackback">TrackBacks (0)</a>
</p>



<h3 class="comments-header" id="comments">Comments</h3>
<div class="comment" id="comment-167580">
<p class="comment-meta" id="c167580">
<span class="comment-meta-author"><strong>Anne van Kesteren </strong></span>
<span class="comment-meta-date"><a href="#c167580">#</a> 2008-10-21</span>
</p>
<div class="comment-bulk">
<p>Including the relevant bits of HTML5 would make XMLHttpRequest huge and put the issues HTML5 has in those areas in XMLHttpRequest.</p>

<p>The problem is slightly more subtle than the way you put it. The Window object as a concept is pretty widely understood. And the way it is used in XMLHttpRequest is not controversial in any way. However, defining the Window object without defining some of the other important bits about it, such as history, navigation, and browsing contexts, does not make a whole lot of sense. (And in fact those concepts apart from history are relevant to XMLHttpRequest.)</p>

<p>(The Window object is not the only reference, other parts include e.g. the definition of event handler attributes or serializing a Document object.)</p>

</div>
</div>


<div class="comment" id="comment-167584">
<p class="comment-meta" id="c167584">
<span class="comment-meta-author"><strong>Karl Dubost <a class="commenter-profile" href="http://www.w3.org/People/karl/"><img alt="Author Profile Page" src="http://www.w3.org/QA/sununga/mt-static/images/comment/mt_logo.png" width="16" height="16" /></a></strong></span>
<span class="comment-meta-date"><a href="#c167584">#</a> 2008-10-21</span>
</p>
<div class="comment-bulk">
<p>Indeed. As I said, flexibility is an asset of W3C to find the right balance. Not always easy to do. Consensus and compromises. If a reference is given to a moving target, during the transition call, it has to be really documented. You basically have to make the case to say that you need to do it that way. </p>

<p>That said, it seems that this issue is advocating for technologies being modular with smaller specifications: easier to move forward, cheaper to write and implement, promote orthogonal design. </p>

<p>Anne, Do you think it would help if the relevant bits were in a smaller specification than the full HTML 5? Do you think it is possible at all?</p>

<p>(unrelated) For example, I have the strong belief that Canvas API  could be put out of html 5 and have its own document and be already a recommendation in something like 3 to 6 months. It's well implemented. There are already plenty of test cases. It should be easy to move to Rec and be document that could be linked to for normative references by more than one technology. </p>

<p>Anne, What is your opinion about that?</p>

</div>
</div>


<div class="comment" id="comment-167608">
<p class="comment-meta" id="c167608">
<span class="comment-meta-author"><strong>Anne van Kesteren </strong></span>
<span class="comment-meta-date"><a href="#c167608">#</a> 2008-10-21</span>
</p>
<div class="comment-bulk">
<p>Though smaller specifications might be easier to take forward and such, two small specifications of size X (Y) probably take more time than having one specification of size 2X (Z), but I don't really have data to back up that thought.</p>

<p>I have a slight preference for having some parts of HTML5 in separate specifications. In theory that's definitely possible as well, of course. However, until we have editor resources (Ian indicates his experience is that Z is simpler than Y) that will probably not happen.</p>

<p>Regarding the canvas element, sure. I do not feel too strongly about it. On the other hand, no it's still in a draft that is in flux we can easily add new features, such as the text API.</p>

</div>
</div>



  <div class="comments-open" id="comments-open">
<h3 class="comments-open-header">Leave a comment</h3>

<div class="comments-open-moderated">
   <p>
   Note: this blog is intended to foster <strong>polite
   on-topic discussions</strong>. Comments failing these
   requirements and spam will not get published. Please,
   enter your real name and email address. Every
   individual comment is reviewed by the W3C staff.
   This may take some time, thank you for your patience.
   </p>
   <p>
   You can use the following HTML markup (a href, b, i, 
   br/, p, strong, em, ul, ol, li, blockquote, pre) 
   and/or <a href="http://daringfireball.net/projects/markdown/syntax">Markdown syntax</a>.</p>
</div>

<div id="comments-open-data">
<form method="post" action="http://www.w3.org/QA/sununga/beach.pl" id="comments-form">
<h4>Your comment</h4>
<div id="comments-open-text">
  <textarea id="comment-text" name="text" rows="20" cols="100"></textarea><br />
<label for="comment-text">Write your comment text here. Remember, keep the discussion on topic and courteous.</label>
</div>

<h4>About you</h4>
<div id="comment-form-name">
  <input type="hidden" name="static" value="1" />
<input type="hidden" name="entry_id" value="582" />
<input type="hidden" name="__lang" value="en" /> 
<label for="comment-author">Your Name</label>
<input id="comment-author" name="author" size="30" value="" />
</div>
<div id="comment-form-email">
<label for="comment-email">Your Email Address</label>
<input id="comment-email" name="email" size="30" value="" />
</div>

<div id="comments-open-footer">
<input type="submit" accesskey="s" name="post" id="comment-submit" value="Submit" />

</div>
</form>
</div>
</div>



<p id="gentime">This page was last generated on $Date: 2011/12/16 03:03:05 $</p> 

      </div><!-- End of "main" DIV. -->

<address>

This blog is written by W3C staff and working group participants,<br />
&nbsp;and maintained by <a href="/People/CMercier/">Coralie Mercier</a>.<br />
Authorized parties may <a href="/QA/new">log in</a> to create a new entry.<br/>
<span id="poweredby">Powered by Movable Type, magpierss and a lot of Web Technology</span>
    </address>


    
    <p class="copyright">
      <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> &copy; 1994-2011
      <a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a>&reg;
      (<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>,
      <a href="http://www.ercim.eu/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
      <a href="http://www.keio.ac.jp/">Keio</a>),
      All Rights Reserved.
      W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
      <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>,
      <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a>
      and <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-software">software licensing</a>
      rules apply. Your interactions with this site are in accordance
      with our <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Public">public</a> and
      <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Members">Member</a> privacy
      statements.
    </p>

  </body>
</html>