[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [sca-bpel-editors] SCA BPEL Spec Editing - Working Draft 2
Hi Anish, the line numbers were turned off in the working draft 1. I am not
aware of a different template - please let me know if you have a link to an
"official" template.
I'll reduce the component/composite syntax snippets in sections 1 and 2 and
upload a working draft 3.
Kind Regards
DK
Dieter König Mail: dieterkoenig@de.ibm.com IBM Deutschland Entwicklung GmbH
Senior Technical Staff Member Tel (office): (+49) 7031-16-3426 Vorsitzender des Aufsichtsrats:
Martin Jetter
Architect, Business Process Fax (office): (+49) 7031-16-4890 Geschäftsführung: Herbert Kircher
Choreographer
Member, Technical Expert Council Tel (home office): (+49) 7032-201464 Sitz der Gesellschaft: Böblingen
Schönaicher Strasse 220, 71032 Registergericht: Amtsgericht
Böblingen, Germany Stuttgart, HRB 243294
Anish Karmarkar
<Anish.Karmarkar@
oracle.com> To
Michael Rowley <mrowley@bea.com>
11.10.2007 02:06 cc
Dieter Koenig1/Germany/IBM@IBMDE,
sca-bpel-editors@lists.oasis-open.o
rg
Subject
Re: [sca-bpel-editors] SCA BPEL
Spec Editing - Working Draft 2
Thanks for making these changes.
Some comments inlined.
-Anish
--
Michael Rowley wrote:
> In general, the changes look good.
>
> Could you also turn line numbering on? It would make it easier to refer
> to specific lines in the spec.
>
Dieter: is this something that you turned it off? I want to ensure that
we are using the right template.
... and yes we should always keep it turned on so that folks can refer
to them when raising issues/discussing them.
> Also, perhaps the <implementation.bpel> line in section 1 should be put
> in bold, since it is the only thing that is different about a BPEL
> component from any other kind of component? I almost wonder whether it
> would be better to _only_ mention the <implementation.bpel> line.
>
I think it would be. This is the problem that we have in the assembly
spec too. The same thing is repeated number of times => chance of
getting it wrong or being out of sync.
I would suggest using "..." for elements and attributes that are not new
(inherited from assembly/policy. This would get rid of the clutter and
focus the reader on BPEL-specific stuff, without being incorrect.
i.e.:
<component ...>
<implementation.bpel process="xs:QName" />
...
</component>
Regardless, having <implementation.bpel> in bold would make sense.
> In section (2), I believe we should change <implementation> to
> <implemenation.bpel> and include a "process" attribute.
>
> The rest looks great.
>
> Michael
>
> -----Original Message-----
> From: Dieter Koenig1 [mailto:dieterkoenig@de.ibm.com]
> Sent: Tuesday, October 09, 2007 9:09 AM
> To: sca-bpel-editors@lists.oasis-open.org
> Subject: [sca-bpel-editors] SCA BPEL Spec Editing - Working Draft 2
>
>
> Dear SCA-BPEL Editors, I applied the issue resolutions BPEL-4 and BPEL-7
> to
> the specification.
>
> As I also performed a number of additional changes, I would like to get
> your ok before I upload the new Working Draft 2 to the OASIS site. The
> attached document (switch to the "Final Showing Markup" option to see
> all
> changes) has the following changes:
> - Issue resolutions BPEL-4, BPEL-7
> - List of XML namespaces
> - Table of Contents formatting
> - References formatting
> - New section "5. Conformance"
> - Syntax and Examples formatting
> plus a few minor paragraph formatting fixes.
>
> ===> Please let me know if this is acceptable (I will rollback selected
> changes otherwise).
> ===> If I don't hear anything then I will upload the document before the
> Thursday TC call.
>
> (See attached file: sca-bpel-draft-2007-10-09.doc)
>
> Kind Regards
> DK
>
> ----- Forwarded by Dieter Koenig1/Germany/IBM on 09.10.2007 14:51 -----
>
>
> Dieter
>
> Koenig1/Germany/I
>
> BM
> To
> OASIS BPEL
>
> 05.10.2007 10:20
> <sca-bpel-editors@lists.oasis-open.
> org>
>
>
> cc
>
>
>
> Subject
> SCA BPEL Spec Editing
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
>
> If nobody objects then I will **take the pen** and apply the first issue
> resolutions (http://www.osoa.org/jira/browse/BPEL-4 and
> http://www.osoa.org/jira/browse/BPEL-7), based on the first working
> draft (
> http://www.oasis-open.org/apps/org/workgroup/sca-bpel/document.php?docum
> ent_id=25422
> ).
>
> Furthermore, I will add a section Conformance as discussed in the 10/4
> call
> (see http://lists.oasis-open.org/archives/sca-bpel/200710/msg00018.html,
> agenda item 7.b) - this will become the last numbered section before the
> appendix sections.
>
> Kind Regards
> DK
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]