W3C home > Mailing lists > Public > xml-dist-app@w3.org > January 2002

Proposed rewrite of Part 1, section 2 (long)

From: Marc Hadley <marc.hadley@sun.com>
Date: Mon, 21 Jan 2002 17:35:45 +0000
Message-ID: <3C4C5171.7040704@sun.com>
To: xml-dist-app@w3.org
All,

The editors have been tasked with improving the overall readability of
the specification and as part of this we would like to propose a rewrite
of section 2. This section has been the subject of a great deal of
"micro-editing" and we are concerned not to lose any detail that may
have been hard fought over in the past. To aid your review we are
including redlined versions of each proposal that show the differences
between the current WD and the proposed rewrite. The redlined version's
filenames are suffixed with "_RL".

The editors would actually like to propose 2 alternative rewrites, both
of which remove the term "anonymous actor" which is not used elewhere in
the specification and is not in the glossary:

(i) The first "SoapProcessingModel.htm" and "SoapProcessingModel_RL.htm"
is the less radical of the two and maintains the current terminology
around SOAP actor and roles.

(ii) The second "SoapProcessingModelNoActor.htm" and
SoapProcessingModelNoActor_RL.htm" proposes more radical changes. The
specification's current use of the word actor is counter-intuitive, e.g.
we speak about SOAP nodes assuming roles named by SOAP actors. In real
life roles are not named by actors, actors play roles and this can lead
to some confusing wording. The second rewrite assumes that we rename the
"actor" attribute to "role".

Marc (on behalf of the other editors: Gudge, Jean-Jacques and Henrik)

-- 
Marc Hadley <marc.hadley@sun.com>
XML Technology Centre, Sun Microsystems.




Received on Monday, 21 January 2002 12:39:28 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 7 December 2009 10:59:06 GMT