W3C home > Mailing lists > Public > public-webapi@w3.org > February 2008

Re: [selectors-api] Best practice in HTML wellformed documents

From: Lachlan Hunt <lachlan.hunt@lachy.id.au>
Date: Fri, 15 Feb 2008 15:23:46 +0100
Message-ID: <47B5A072.8000002@lachy.id.au>
To: "Diego La Monica (IWA/HWG)" <d.lamonica@webprofession.com>
CC: public-webapi@w3.org

Diego La Monica (IWA/HWG) wrote:
> Proposal: Makes the example in the section 1.1 always valid and correct.
> Solution: closing the unclosed tags.
> Result: the document will be both HTML 4.01 valid and XHTML valid document.

I have considered this issue further and discussed it with Anne (my 
co-editor), and, for the following reasons, the example has not been 
changed.

1. The spec only claimed that it is an HTML table, not XHTML.
2. The markup is conforming HTML 4.01.
3. Changing the example does not resolve any technical issues with the
    spec.
3. Changing example markup unnecessarily increases the risk of
    introducing errors into the specification.
4. It is important to illustrate that this API can be used in both HTML
    and XHTML, and there is an XHTML example elsewhere in the spec.
5. The HTML markup is more concise than XHTML compatible markup.
6. Authors that choose to use XHTML should be competent enough
    to realise how to convert the example to XHTML, in the unlikely
    event that they would want to use that table in their own page,
    rather than, say, using the script for their own table.

However, I have made the following changes to the spec:

1. The spec now explicitly states that the markup is HTML 4.01.
2. I explained that the example script will also function with an
    equivalent table written in XHTML markup.

(These changes will appear in the draft next time I check it into CVS, 
later this evening.)

-- 
Lachlan Hunt - Opera Software
http://lachy.id.au/
http://www.opera.com/
Received on Friday, 15 February 2008 14:24:01 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Friday, 15 February 2008 14:24:02 GMT