W3C home > Mailing lists > Public > public-rdf-dawg@w3.org > October to December 2004

Re: Yoshio's review

From: Seaborne, Andy <andy.seaborne@hp.com>
Date: Thu, 02 Dec 2004 13:21:26 +0000
Message-ID: <41AF16D6.6080705@hp.com>
To: Dan Connolly <connolly@w3.org>
CC: public-rdf-dawg@w3.org



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 GMT

This archive was generated by hypermail 2.3.1 : Tuesday, 26 March 2013 16:15:21 GMT