- From: Christopher Ferris <chris.ferris@sun.com>
- Date: Wed, 05 Dec 2001 15:55:29 -0500
- 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