W3C home > Mailing lists > Public > www-tag@w3.org > August 2002

Re: 13 Aug Arch Doc available for review (skw-...01)

From: Ian B. Jacobs <ij@w3.org>
Date: Thu, 15 Aug 2002 10:33:50 -0400
Message-ID: <3D5BBBCE.8020403@w3.org>
To: Tim Bray <tbray@textuality.com>
CC: "Williams, Stuart" <skw@hplb.hpl.hp.com>, "'Dan Connolly'" <connolly@w3.org>, www-tag@w3.org

Tim Bray wrote:
> Williams, Stuart wrote:
> 
>> I would like someone to be able to read just the Introduction to our
>> document and to come away with an appreciation of Web Architecture. The
>> (current) title of the document is "Architectural Principles of the World
>> Wide Web". A question I would expect to be answered by the end of the
>> introduction is *what* those prinicples are. We have indicated that we 
>> aim
>> to minimalist in the sense of state some minimum number of
>> necessary/important/essential principles - so the list should not be
>> unmanagably large. I don't think we should be challenging our readers to
>> 'weed' them out from a longer narrative. I think we should state them
>> together, up front near the beginning of the document and 
>> justify/motivate
>> them in the sequel.
>>
>> Different people will approach our document with different intent. 
>> Some will
>> approach with a spirit of enquiry; Some to question/challenge whether 
>> they
>> share in whatever concensus the document represents; Some in search of an
>> authorative source to resolve an issue... thus spake the TAG. I think 
>> each
>> audience is better served by actually stating the architectural 
>> principles
>> near the front.
> 
> 
> I agree with this 100%. -Tim

One solution is to create a separate page (short, printable) and
draw attention to that page early in the document. If we have
three views:

  1) Principles only
  2) Principles and some fluff like examples
  3) Principles and even more fluff and commentary

I would like "the document" to be view (2), and view (1) to
be separate but readily available.

  _ Ian



-- 
Ian Jacobs (ij@w3.org)   http://www.w3.org/People/Jacobs
Tel:                     +1 718 260-9447
Received on Thursday, 15 August 2002 10:37:22 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 7 January 2015 15:32:33 UTC