Re: Yoshio's review

Dan Connolly wrote:
> 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.

Good to know that - personally, I don't mind so I'm guided by what people find 
makes the doc easier including for non-English speakers.

Which ever way it gets done, soemthing needs to change to make it more  consistent.

> 
> 
>>  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.
> 

Received on Thursday, 2 December 2004 13:22:01 UTC