W3C home > Mailing lists > Public > public-swbp-wg@w3.org > April 2004

Re: [OEP] "Classes as values": summary of the discussion so far and second draft $swbpd

From: Jeremy Carroll <jjc@hplb.hpl.hp.com>
Date: Wed, 28 Apr 2004 14:39:53 +0100
Message-ID: <408FB429.8060501@hplb.hpl.hp.com>
To: ewallace@cme.nist.gov
Cc: public-swbp-wg@w3.org, guarino@loa-cnr.it

ewallace@cme.nist.gov wrote:

> "Uschold, Michael F" <michael.f.uschold@boeing.com> wrote:
> 
>>On document length...
>>
>>To the extent that we have spen the time producing useful content, I think 
>>it would be a shame to cut it out just to keep documents short. Perhaps 
>>better is to structure the documents so that there is a good exec summary, 
>>and for those that wish to dig deeper, extra details may be provided.  Much 
>>easier in a Web document, but possible for flat documents too, with extra 
>>work. There could two or even three levels of depth for those who really 
>>want the gory details. Much more work to produce - a question of balance 
>>and priorities and what authors feel inspired to do.
> 
> 
> I agree with this.  Don't delete information, just make it easier to find.
> A standard structure for these notes would certainly help with this.
> 
> -Evan
> 

Length limits often are a good discipline for being concise and getting 
to the point. (I am not sufficiently informed to have an opinion on the 
specific note in question)

Jeremy
Received on Wednesday, 28 April 2004 09:41:02 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 17:30:53 UTC