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

This archive was generated by hypermail 2.3.1 : Wednesday, 7 January 2015 15:00:45 UTC