<?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>9959</bug_id>
          
          <creation_ts>2010-06-20 06:28:44 +0000</creation_ts>
          <short_desc>Remove the wording&quot;polyglot document&quot; and incorporate formulations from title instead</short_desc>
          <delta_ts>2010-10-05 13:07:37 +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 HTML/XHTML Compat. Authoring Guide (ed: Eliot Graff)</component>
          <version>unspecified</version>
          <rep_platform>All</rep_platform>
          <op_sys>All</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc>http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html#abstract</bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>FPWD</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Leif Halvard Silli">xn--mlform-iua</reporter>
          <assigned_to name="Eliot Graff">eliotgra</assigned_to>
          <cc>eliotgra</cc>
    
    <cc>mike</cc>
    
    <cc>public-html-admin</cc>
    
    <cc>public-html-wg-issue-tracking</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>36277</commentid>
    <comment_count>0</comment_count>
    <who name="Leif Halvard Silli">xn--mlform-iua</who>
    <bug_when>2010-06-20 06:28:44 +0000</bug_when>
    <thetext>It is important to develop a strong terminology for the polyglot spec .

The proposed, new title (&quot;Polyglot Markup: HTML-Compatible XHTML Documents&quot;) introduces some new wordings: &quot;Polyglot Markup&quot;, &quot;HTML-compatible&quot; and &quot;HTML-compatible XHTML document&quot;. Please build these and simlar wordings into the body text. Also, the reaction to the phrase &apos;polyglot document&apos; was that it was possible to misunderstand and so, even in the text, it should be avoided both for that reason and in order to instead underline the phrases from the titlte.

I also believe &apos;HTML polyglot&apos; as synonym for &apos;HTML-compatible XHTML documents&apos; is worth using in the text (even if it did not work in the title).

As example of an important text, I suggest the following amendment of the Abstract, as an example of how the suggested formulations can be built into the spec text:

[[
This specification defines Polyglot Markup, an HTML-compatible XHTML document format. Documents of this kind are also known as HTML polyglots. An HTML polyglot is an HTML5 document which is at the same time an XML document and an HTML document. HTML polyglots that meet these constraints are, per the HTML5 specification, interpreted as compatible, regardless of whether they are processed as HTML or as XHTML. An HTML polyglot is obligated to have an XML- and HTML5-compatible doctype, to use namespace declarations, and to use a specific case—normally lower case but occasionally camel case—for element and attribute names. HTML polyglots use lower case for certain attribute values. Further constraints include those on empty elements, named entity references, and the use of scripts and style.
[[</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>36310</commentid>
    <comment_count>1</comment_count>
    <who name="Eliot Graff">eliotgra</who>
    <bug_when>2010-06-21 21:11:42 +0000</bug_when>
    <thetext>Changed &apos;polyglot document&apos; to &apos;polyglot markup&apos; throughout</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>36697</commentid>
    <comment_count>2</comment_count>
    <who name="Eliot Graff">eliotgra</who>
    <bug_when>2010-07-08 21:26:19 +0000</bug_when>
    <thetext>Changed throughout and verified in FPWD.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>