W3C home > Mailing lists > Public > public-html-commits@w3.org > May 2010

html5/html-xhtml-author-guide html-xhtml-authoring-guide.html,1.4,1.5

From: Eliot Graff via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 04 May 2010 21:05:52 +0000
To: public-html-commits@w3.org
Message-Id: <E1O9PJQ-0004qw-Hj@lionel-hutz.w3.org>
Update of /sources/public/html5/html-xhtml-author-guide
In directory hutz:/tmp/cvs-serv18640

Modified Files:
	html-xhtml-authoring-guide.html 
Log Message:
Removed requirement to include a space before the trailing / and > of empty elements; replaced attribute "values" with either "letters" or "characters" as appropriate; In section 4, changed "guidelines" to "rules";

Index: html-xhtml-authoring-guide.html
===================================================================
RCS file: /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- html-xhtml-authoring-guide.html	22 Apr 2010 14:07:12 -0000	1.4
+++ html-xhtml-authoring-guide.html	4 May 2010 21:05:50 -0000	1.5
@@ -1,18 +1,13 @@
 <!DOCTYPE HTML>
 <html dir="ltr" lang="en"><head>
 
-
   
     <title>HTML/XHTML Compatibility Authoring Guidelines</title>
     <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
     <!-- 
-
       === NOTA BENE ===
-
       For the three scripts below, if your spec resides on dev.w3 you can check them
-
       out in the same tree and use relative links so that they'll work offline,
-
      -->
     
     
@@ -20,8 +15,7 @@
 href="html-xhtml-authoring-guide_files/respec.css"><link charset="utf-8"
  type="text/css" rel="stylesheet" 
 href="html-xhtml-authoring-guide_files/W3C-ED.css"></head><body 
-style="display: inherit;"><div firebugversion="1.5.3" style="display: 
-none;" id="_firebugConsole"></div><div class="head"><p><a 
+style="display: inherit;"><div class="head"><p><a 
 href="http://www.w3.org/"><img 
 src="html-xhtml-authoring-guide_files/w3c_home.png" alt="W3C" width="72"
  height="48"></a></p><h1 class="title" id="title">HTML/XHTML 
@@ -30,12 +24,9 @@
 Consortium">W3C</acronym> Editor's Draft 21 April 2010</h2><dl><dt>This 
 version:</dt><dd><a 
 href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html">http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html</a></dd><dt>Latest
-
  published version:</dt><dd><a href="http://www.w3.org/TR/xxx-xxx/">http://www.w3.org/TR/xxx-xxx/</a></dd><dt>Latest
-
  editor's draft:</dt><dd><a 
 href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html">http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html</a></dd><dt>Previous
-
  version:</dt><dd>none</dd><dt>Editor:</dt><dd>Eliot Graff, Microsoft 
 Corporation</dd></dl><p class="copyright"><a 
 href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a>
@@ -51,7 +42,6 @@
 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>
  and <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document
-
  use</a> rules apply.</p><hr></div>
     <div class="introductory section" id="abstract"><h2>Abstract</h2>
       <p>This document summarizes design guidelines for authors who wish
@@ -64,6 +54,11 @@
 rel="biblioentry" class="bibref">HTML5</a>] and [<a href="#bib-RFC2854" 
 rel="biblioentry" class="bibref">RFC2854</a>] respectively.
       </p>
+      <p><strong>Note:</strong>   If your browser does not render the 
+fully-formatted version of this document with images and color fonts, 
+please see <a 
+href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide-rendered.html">the
+ version without scripts</a>.</p>
     </div><div id="sotd" class="introductory section"><h2>Status of This
  Document</h2><p><em>This section describes the status of this document 
 at the time of its publication. Other documents may supersede this 
@@ -78,7 +73,6 @@
 href="mailto:public-html@w3.org">public-html@w3.org</a> (<a 
 href="mailto:public-html-request@w3.org?subject=subscribe">subscribe</a>,
  <a href="http://lists.w3.org/Archives/Public/public-html/">archives</a>).
-
  All feedback is welcome.</p><p>Publication as a Editor's Draft does not
  imply endorsement by the <acronym title="World Wide Web Consortium">W3C</acronym>
  Membership. This is a draft document and may be updated, replaced or 
@@ -94,10 +88,8 @@
 individual who has actual knowledge of a patent which the individual 
 believes contains <a 
 href="http://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential">Essential
-
  Claim(s)</a> must disclose the information in accordance with <a 
 href="http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">section
-
  6 of the <acronym title="World Wide Web Consortium">W3C</acronym> 
 Patent Policy</a>.</p></div><div class="section" id="toc"><h2 
 class="introductory">Table of Contents</h2><ul class="toc"><li 
@@ -109,10 +101,8 @@
 class="secno">3. </span>The DOCTYPE</a></li><li class="tocline"><a 
 class="tocxref" href="#namespaces"><span class="secno">4. </span>Namespaces</a></li><li
  class="tocline"><a class="tocxref" href="#elements"><span class="secno">5.
-
  </span>Elements</a><ul class="toc"><li class="tocline"><a 
 class="tocxref" href="#required-elements"><span class="secno">5.1 </span>Required
-
  Elements</a><ul class="toc"><li class="tocline"><a class="tocxref" 
 href="#tables"><span class="secno">5.1.1 </span>Tables</a></li></ul></li><li
  class="tocline"><a class="tocxref" href="#case-sensitivity"><span 
@@ -120,20 +110,17 @@
 class="tocline"><a class="tocxref" href="#element-names"><span 
 class="secno">5.2.1 </span>Element Names</a></li><li class="tocline"><a 
 class="tocxref" href="#attribute-names"><span class="secno">5.2.2 </span>Attribute
-
  Names</a></li><li class="tocline"><a class="tocxref" 
-href="#attribute-values"><span class="secno">5.2.3 </span>Attribute 
-Values</a></li></ul></li><li class="tocline"><a class="tocxref" 
+href="#attribute-characters"><span class="secno">5.2.3 </span>Attribute 
+Characters</a></li></ul></li><li class="tocline"><a class="tocxref" 
 href="#empty-elements"><span class="secno">5.3 </span>Empty Elements</a></li></ul></li><li
  class="tocline"><a class="tocxref" href="#attributes"><span 
 class="secno">6. </span>Attributes</a></li><li class="tocline"><a 
 class="tocxref" href="#named-entity-references"><span class="secno">7. </span>Named
-
  Entity References</a></li><li class="tocline"><a class="tocxref" 
 href="#script-and-style"><span class="secno">8. </span>Script and Style</a><ul
  class="toc"><li class="tocline"><a class="tocxref" 
 href="#external-script-and-style"><span class="secno">8.1 </span>External
-
  Script and Style</a></li><li class="tocline"><a class="tocxref" 
 href="#in-line-script-and-style"><span class="secno">8.2 </span>In-line 
 Script and Style</a></li></ul></li><li class="tocline"><a 
@@ -163,13 +150,9 @@
 documents and XML documents. 
  
         	<!-- <ul>
-
  			TODO: in this section:
-
         		<li>Offer "top-tier" summary of general guidelines to conform to polyglot language.</li>
-
         		<li>Link to more detailed analysis below.</li>
-
         	</ul>  -->
         
       </p>
@@ -200,7 +183,6 @@
 	<p>
 		For a polyglot document, you <em title="must" class="rfc2119">must</em>
  use the <a href="http://dev.w3.org/html5/spec/syntax.html#the-doctype">HTML
-
  DOCTYPE</a>.
 	</p>
 	</div>    
@@ -208,7 +190,7 @@
     <div class="section" id="namespaces">
       <!--OddPage--><h2><span class="secno">4. </span>Namespaces</h2>
       <p>
-        The following guidelines apply to namespaces used in polyglot 
+        The following rules apply to namespaces used in polyglot 
 documents.
       </p>
       <ul>
@@ -433,11 +415,11 @@
 	        			</ul>
 			</div>
 	
-			<div class="section" id="attribute-values">
-			<h4><span class="secno">5.2.3 </span>Attribute Values</h4>
+			<div class="section" id="attribute-characters">
+			<h4><span class="secno">5.2.3 </span>Attribute Characters</h4>
 				<p>
 					You <em title="must" class="rfc2119">must</em> specify attribute 
-values as lowercase.
+letters as lowercase.
 				</p>
 			</div>
 	    </div>
@@ -466,14 +448,8 @@
 				<li><code>source</code></li>
 			</ul>
 	      <p>
-	      	You <em title="should" class="rfc2119">should</em> include a 
-space before the trailing <code>/</code> and <code>&gt;</code> of empty 
-elements, e.g. <code>&lt;br /&gt;</code>, <code>&lt;hr /&gt;</code> and <code>&lt;img
-
- src="karen.jpg" alt="Karen" /&gt;</code>. 
-	      	Also, you <em title="should" class="rfc2119">should</em> use the
- minimized tag syntax for empty elements, e.g. <code>&lt;br /&gt;</code>.
- 
+	      	You <em title="should" class="rfc2119">should</em> use the 
+minimized tag syntax for empty elements, e.g. <code>&lt;br/&gt;</code>. 
 	      	The alternative syntax <code>&lt;br&gt;&lt;/br&gt;</code> 
 allowed by XML gives uncertain results in many existing user agents.
 	      </p>
@@ -481,7 +457,6 @@
 	      	Given an empty instance of an element whose content model is not
  EMPTY (for example, an empty title or paragraph) do not use the 
 minimized form (e.g. use <code>&lt;p&gt; &lt;/p&gt;</code> and not <code>&lt;p
-
  /&gt;</code>).
 	      </p>
 	      <p>
@@ -494,8 +469,8 @@
 	<div class="section" id="attributes">
 	<!--OddPage--><h2><span class="secno">6. </span>Attributes</h2>
 		<p>Avoid line breaks and multiple white space characters within 
-attribute values. These are handled inconsistently by user agents.</p>
-		<p>See also <a href="#attribute-values">Attribute Values</a>.</p>
+attribute characters. These are handled inconsistently by user agents.</p>
+		<p>See also <a href="#attribute-values">Attribute Characters</a>.</p>
 	
 	</div>
 
@@ -633,7 +608,6 @@
 class="secno">B. </span>References</h2><div class="section" 
 id="normative-references"><h3><span class="secno">B.1 </span>Normative 
 references</h3><dl class="bibliography"><dt id="bib-HTML5">[HTML5]</dt><dd>Ian
-
  Hickson; David Hyatt. <a 
 href="http://www.w3.org/TR/2010/WD-html5-20100304/"><cite>HTML 5.</cite></a>
  4 March 2010. W3C Working Draft. (Work in progress.) URL: <a 
Received on Tuesday, 4 May 2010 21:05:54 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 4 May 2010 21:05:54 GMT