W3C home > Mailing lists > Public > www-html@w3.org > August 2000

RE: XHTML Invalidity / WML2 / New XHTML 1.1 Attribute

From: Christian Smith <csmith@barebones.com>
Date: Fri, 11 Aug 2000 10:28:40 -0400
To: www-html@w3.org
Message-ID: <20000811102840-f01010601-88d68f06@204.107.232.107>
On Friday, August 11, 2000 at 15:36, bertilow@hem.passagen.se (Bertilo Wennergren) wrote:

>   <img src="bluemoon.gif" />
>   <!-- replace with better image when X delivers -->
>   <img src="greencheese.gif" />
>   <!-- This image has been approved by the boss -->
>   <img src="blackbird.gif" />
>   <img src="whitesnow.gif" />
> 
> "This image"? Which image? How much clearer and more convenient with
> comment attributes!
> 
> And then, in XHTML used as XML, applications can be made to _act_
> upon the content of comment attributes!

Just use more care when writing your comments. Embeding the comment into a
tag isn't going to solve the issue of people being lazy about their
comments. Your comment should have a date, the person who made the comment
and specific references to the object being commented on.

Bad:
<!-- replace with better image when X delivers -->


Good:
<!-- 
	  Date: 8/11/2000 
	Author: Chris Jones
	Status: Review 
	The bluemoon.gif file is just a placeholder logo
	Maddy says Dave has a friend who does graphic design
	and he is going to do something fancy in exchange for
	some work he needs doing
-->


Beter:
<!-- 
<date>8/11/2000</date>
<author>Chris Jones</author>
<status>Review</status>
<reference>bluemoon.gif</reference>
<content>
	The bluemoon.gif file is just a placeholder logo
	Maddy says Dave has a friend who does graphic design
	and he is going to do something fancy in exchange for
	some work he needs Dave to do (I'm not asking, I don't want to know)
</content>
-->

Sure, it's more work but the result is infinitely more useful (the
mathematical proof of this statement is left as an exercise to the reader).

-- 
Christian Smith  |  csmith@barebones.com  |  http://web.barebones.com

He who dies with the most friends... Is still dead!
Received on Friday, 11 August 2000 10:27:37 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Tuesday, 27 March 2012 18:15:43 GMT