[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
Thanks. BTW, if you ever need to get to the templates they are located at: http://docs.oasis-open.org/templates/ I just wanted to ensure that we are sticking to the template, which we are. -Anish -- Dieter Koenig1 wrote: > 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]