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

I agree with Jeremy that length limits often do produce better documents. It is a question of judgment, whether to leave something out because it is rambling vs. legitimate and very useful extra detail giving people deeper insights into an issue.


 -----Original Message-----
From: 	Jeremy Carroll [] 
Sent:	Wednesday, April 28, 2004 6:40 AM
Subject:	Re: [OEP] "Classes as values": summary of the discussion so far   and second draft  $swbpd wrote:

> "Uschold, Michael F" <> 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)


Received on Wednesday, 28 April 2004 12:39:02 UTC