This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 9959 - Remove the wording"polyglot document" and incorporate formulations from title instead
Summary: Remove the wording"polyglot document" and incorporate formulations from title...
Status: RESOLVED FIXED
Alias: None
Product: HTML WG
Classification: Unclassified
Component: pre-LC1 HTML/XHTML Compat. Authoring Guide (ed: Eliot Graff) (show other bugs)
Version: unspecified
Hardware: All All
: P2 normal
Target Milestone: FPWD
Assignee: Eliot Graff
QA Contact: HTML WG Bugzilla archive list
URL: http://dev.w3.org/html5/html-xhtml-au...
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2010-06-20 06:28 UTC by Leif Halvard Silli
Modified: 2010-10-05 13:07 UTC (History)
4 users (show)

See Also:


Attachments

Description Leif Halvard Silli 2010-06-20 06:28:44 UTC
It is important to develop a strong terminology for the polyglot spec .

The proposed, new title ("Polyglot Markup: HTML-Compatible XHTML Documents") introduces some new wordings: "Polyglot Markup", "HTML-compatible" and "HTML-compatible XHTML document". Please build these and simlar wordings into the body text. Also, the reaction to the phrase 'polyglot document' 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 'HTML polyglot' as synonym for 'HTML-compatible XHTML documents' 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.
[[
Comment 1 Eliot Graff 2010-06-21 21:11:42 UTC
Changed 'polyglot document' to 'polyglot markup' throughout
Comment 2 Eliot Graff 2010-07-08 21:26:19 UTC
Changed throughout and verified in FPWD.