W3C home > Mailing lists > Public > xml-dist-app@w3.org > December 2001

Re: TBTF pieces for the specs

From: Christopher Ferris <chris.ferris@sun.com>
Date: Wed, 05 Dec 2001 15:55:29 -0500
Message-ID: <3C0E89C1.3070901@sun.com>
To: Glen Daniels <gdaniels@macromedia.com>
CC: David Fallside <fallside@us.ibm.com>, xml-dist-app@w3.org
+1, I made some similar comments to Marc this a.m.
The general content is about right but the editorial
style is inconsistent with the spec.

Cheers,

Chris

Glen Daniels wrote:

> Hi David:
> 
> Stuart made some very similar comments in a private note as well.  I was in
> a bit of a rush yesteday, and so pretty much took that text (which was the
> last bit I edited) unedited from the earlier MEP document, where it was
> certainly intended in a more conversational style.  I agree it needs some
> work.
> 
> Thanks for the comments, and I'll certainly take you up on the offer to
> help.  Let's plan to get this "en-spec'ed" over the next day or two.
> 
> --Glen
> 
> ----- Original Message -----
> From: "David Fallside" <fallside@us.ibm.com>
> To: "Glen Daniels" <gdaniels@macromedia.com>
> Cc: <xml-dist-app@w3.org>
> Sent: Wednesday, December 05, 2001 1:25 PM
> Subject: Re: TBTF pieces for the specs
> 
> 
> 
>>Glen, thanks for working on these pieces. Regarding the description of
>>"Conventions for describing state as properties" (1), I think it's content
>>is basically about right but it will need some further editorial work. For
>>example:
>>-- The subsection "Properties, Features ....." starts with the statement
>>"We have had some discussion .... The view advanced here .....": This type
>>of voice is inappropriate for spec text. I suggest a simple fix is to
>>
> start
> 
>>the paragraph with "A message is an abstraction of the information .... ",
>>i.e. delete the first sentence and the beginning of the second.
>>-- Similarly, the last paragraph "We leave it open (at least for now)
>>
> ...."
> 
>>should be changed to something like "A property may appear ....".
>>-- The subsection "Properties, Features ....." also needs some more
>>organisation and a crisper style. Breaking up that subsection's first
>>paragraph would make it less dense, and shortening some of the sentences
>>would improve readability (e.g. the paragraph starting "Having abstracted
>>messages ..." consists of a single sentence).
>>I am available over the next few days to help edit.
>>Regards,
>>David
>>
>>............................................
>>David C. Fallside, IBM
>>Ext Ph: 530.477.7169
>>Int  Ph: 544.9665
>>fallside@us.ibm.com
>>
>>
>>
>>
>>                    Glen Daniels
>>                    <gdaniels@macrome       To:
>>
> "'xml-dist-app@w3.org'" <xml-dist-app@w3.org>
> 
>>                    dia.com>                cc:
>>                    Sent by:                Subject:     TBTF pieces for
>>
> the specs
> 
>>                    xml-dist-app-requ
>>                    est@w3.org
>>
>>
>>                    12/04/2001 10:00
>>                    AM
>>
>>
>>
>>
>>
>>
>>
>>All:
>>
>>Here are the current versions of the four pieces which the TBTF proposes
>>inserting into the upcoming WD.
>>
>>The Binding Framwork itself may be found at [1].  This will become section
>>5
>>(I believe) of Section 1.
>>
>>The other pieces, which all go in Section 2 (Adjuncts), are attached to
>>this
>>message.  As a reminder, they are:
>>
>>1) A description of the property naming/typing conventions, plus the
>>"logical architecture", which we use in the following pieces.
>>
>>2) A description of Transport MEPs, and a specification for a
>>"Simple-Request-Repsonse" MEP.
>>
>>3) An HTTP binding per the framework, using the property convention and
>>
> the
> 
>>Simple-Request-Repsonse MEP.
>>
>>These pieces were mostly taken wholesale from earlier text which the TF
>>
> had
> 
>>produced.  The structure has changed a bit, and some small edits have been
>>done in a few places.
>>
>>A "merged" version of this text to see how it appears in the actual flow
>>
> of
> 
>>the WD should be available tomorrow.
>>
>>--Glen
>>
>>[1]
>>
>>
> http://lists.w3.org/Archives/Public/www-archive/2001Dec/att-0008/01-SOAPBind
> 
>>ingFramework-01.html
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>
>>#### Default HTTP Binding.htm has been removed from this note on December
>>05 2001 by David Fallside
>>#### Framework-Properties.png has been removed from this note on December
>>05 2001 by David Fallside
>>#### PropertyConventions.html has been removed from this note on December
>>05 2001 by David Fallside
>>#### Requesting-STD.png has been removed from this note on December 05
>>
> 2001
> 
>>by David Fallside
>>#### Responding-STD.png has been removed from this note on December 05
>>
> 2001
> 
>>by David Fallside
>>#### SRR-Std.png has been removed from this note on December 05 2001 by
>>David Fallside
>>#### Transport Message Exchange Pattern.htm has been removed from this
>>
> note
> 
>>on December 05 2001 by David Fallside
>>
>>
>>
>>
> 
Received on Wednesday, 5 December 2001 15:59:41 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 5 February 2014 22:28:13 UTC