Re: Square-bracket output of Definition in specs is bogus

* Roy T. Fielding wrote:
>The output chosen for definitions in W3C specs is easily the worst 
>example
>of spec language abuse that I have ever seen.  Definitions are supposed 
>to
>highlighted to the reader, not placed in obscurity through the addition 
>of
>[Definition: ...].  Mark-up should never obscure CONTENT.

The "Definition:" clearly highlights the definition and the square
brackets clearly delimit the definition from other text in the same
paragraph. This style is widely used in W3C Technical Reports and
well-understood by the target audience; you are the first one who
complains about it as far as I can tell; I do not agree that the
style is "obscure" in a meaningful way. If there are going to be
such changes, the new style should be much more usable than the old
style. You have unfortunately not proposed a style that would.
-- 
Björn Höhrmann · mailto:bjoern@hoehrmann.de · http://bjoern.hoehrmann.de
Weinh. Str. 22 · Telefon: +49(0)621/4309674 · http://www.bjoernsworld.de
68309 Mannheim · PGP Pub. KeyID: 0xA4357E78 · http://www.websitedev.de/ 

Received on Wednesday, 8 December 2004 18:07:53 UTC