<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>10895</bug_id>
          
          <creation_ts>2010-09-30 19:48:51 +0000</creation_ts>
          <short_desc>Use markup compatible with both HTML/XML syntax in examples</short_desc>
          <delta_ts>2011-01-05 18:33:13 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>HTML WG</product>
          <component>pre-LC1 HTML5 spec (editor: Ian Hickson)</component>
          <version>unspecified</version>
          <rep_platform>PC</rep_platform>
          <op_sys>Windows NT</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>WONTFIX</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords>TrackerIssue</keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>---</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Peter Winnberg">peter.winnberg</reporter>
          <assigned_to name="Ian &apos;Hixie&apos; Hickson">ian</assigned_to>
          <cc>hsivonen</cc>
    
    <cc>ian</cc>
    
    <cc>julian.reschke</cc>
    
    <cc>me</cc>
    
    <cc>mike</cc>
    
    <cc>public-html-admin</cc>
    
    <cc>public-html-wg-issue-tracking</cc>
    
    <cc>rubys</cc>
          
          <qa_contact name="HTML WG Bugzilla archive list">public-html-bugzilla</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>40281</commentid>
    <comment_count>0</comment_count>
    <who name="Peter Winnberg">peter.winnberg</who>
    <bug_when>2010-09-30 19:48:51 +0000</bug_when>
    <thetext>When possible, try to use markup that is compatible with both the HTML *and* XML syntax in the examples (i.e., follow Polyglot Markup guide, http://www.w3.org/TR/html-polyglot/).</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>40390</commentid>
    <comment_count>1</comment_count>
    <who name="Henri Sivonen">hsivonen</who>
    <bug_when>2010-10-01 07:29:21 +0000</bug_when>
    <thetext>I think this should be WONTFIXed. The polyglot syntax has very limited actual utility. Using it examples would suggest to authors who read the spec (and who might then lecture to other authors at conferences) that the polyglot syntax is a &quot;best practice&quot; since it&apos;s always used in examples. This could lead to authors to expend useless effort in order to use the polyglot syntax when there&apos;s no benefit.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>40937</commentid>
    <comment_count>2</comment_count>
    <who name="Ian &apos;Hixie&apos; Hickson">ian</who>
    <bug_when>2010-10-11 21:46:58 +0000</bug_when>
    <thetext>EDITOR&apos;S RESPONSE: This is an Editor&apos;s Response to your comment. If you are satisfied with this response, please change the state of this bug to CLOSED. If you have additional information and would like the editor to reconsider, please reopen this bug. If you would like to escalate the issue to the full HTML Working Group, please add the TrackerRequest keyword to this bug, and suggest title and text for the tracker issue; or you may create a tracker issue yourself, if you are able to do so. For more details, see this document:
   http://dev.w3.org/html5/decision-policy/decision-policy.html

Status: Rejected
Change Description: no spec change
Rationale: see comment 1. There&apos;s nothing wrong with just using text/html syntax (in text/html documents) or just using XML syntax (in XML documents); there&apos;s almost never a need to try to write in the very limited subset that is both, and especially no reason to encourage it.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>43187</commentid>
    <comment_count>3</comment_count>
    <who name="Peter Winnberg">peter.winnberg</who>
    <bug_when>2010-12-08 08:00:18 +0000</bug_when>
    <thetext>(In reply to comment #2)
&gt; EDITOR&apos;S RESPONSE: This is an Editor&apos;s Response to your comment. If you are
&gt; satisfied with this response, please change the state of this bug to CLOSED. If
&gt; you have additional information and would like the editor to reconsider, please
&gt; reopen this bug. If you would like to escalate the issue to the full HTML
&gt; Working Group, please add the TrackerRequest keyword to this bug, and suggest
&gt; title and text for the tracker issue; or you may create a tracker issue
&gt; yourself, if you are able to do so. For more details, see this document:
&gt;    http://dev.w3.org/html5/decision-policy/decision-policy.html
&gt; 
&gt; Status: Rejected
&gt; Change Description: no spec change
&gt; Rationale: see comment 1. There&apos;s nothing wrong with just using text/html
&gt; syntax (in text/html documents) or just using XML syntax (in XML documents);
&gt; there&apos;s almost never a need to try to write in the very limited subset that is
&gt; both, and especially no reason to encourage it.

The HTML5 specification has both a HTML and a XML syntax. It makes no sense to have examples of just one of them when they many of them easily could be changed to be compatible with both. This does not mean that authors cannot use markup that isnt compatible with both.

There is of course another solution to this and that is to move the examples to separate document(s) that has examples of both. But that would be a lot more work.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>43826</commentid>
    <comment_count>4</comment_count>
    <who name="Sam Ruby">rubys</who>
    <bug_when>2011-01-05 18:33:13 +0000</bug_when>
    <thetext>http://www.w3.org/html/wg/tracker/issues/149</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>