Re: Yoshio's review

On Dec 2, 2004, at 6:32 AM, Seaborne, Andy wrote:
> Seaborne, Andy wrote:
>>> (2) There is considerable redunduncy (repetions), which may puzzle 
>>> readers.
>>> I prefer the style with definitions first and examples later.
>>> Some terms are used before their definitions.
> Kevin asked for the same.

Lest you get the impression that everybody prefers it that way,
I prefer examples first. I think people go from concrete to abstract 
more easily
than abstract to concrete.

>   I will rearrange to put definition first but this is not likely 
> before the next WD publication because people are rvewing the document 
> at the moment and because it needs a little more time to then make the 
> text read correctly.

I encourage you to do a small experiment with a section or two and see 
if you think it
reads better with definitions before or after examples and let us know 
how it goes.

I can imagine that a little of each might work.

Dan Connolly, W3C

Received on Thursday, 2 December 2004 12:54:01 UTC