OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

ws-tx-editors message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: RE: [ws-tx-editors] Fw: Editors instructions






Fair question.

#2 represents a fully-qualified artifact location in which the artifact
name is giddily trying to follow a point-in-time pseudo-recommendation from
an unapproved and out of date artifact-naming guideline document written by
a subset of the TAB which has been subsequently revised in another document
that many people dislike.
Its not (yet) an exact science. But the "wstx-" prefix in the artifact name
is metadata that identifies the TC.

We can agree we don't need the "wstx-" prefix in our spec names if we wish;
I suggest we keep with it for now just to get something out in open and
then discuss it once we have some specs to review.

Regards,
Ian Robinson
STSM, WebSphere Messaging and Transactions Architect
IBM Hursley Lab, UK
ian_robinson@uk.ibm.com


                                                                           
             Thomas Freund                                                 
             <tjfreund@us.ibm.                                             
             com>                                                       To 
                                       Ian Robinson/UK/IBM@IBMGB           
             03/03/2006 13:13                                           cc 
                                       Andrew Wilkinson3/UK/IBM@IBMGB,     
                                       "Max Feingold"                      
                                       <Max.Feingold@microsoft.com>,       
                                       ws-tx-editors@lists.oasis-open.org  
                                                                   Subject 
                                       RE: [ws-tx-editors] Fw: Editors     
                                       instructions                        
                                                                           
                                                                           
                                                                           
                                                                           
                                                                           
                                                                           




I opt for using #1 (as per Ian's suggestion & using the 2006/03 date) ...
just out of curiosity why is it that that the namespace slightly different
between the two ... i.e. #1 is fine with just "wscoor" where #2 is
"wstx-wscoor" (where everthing prepending that portion is the same)

Regards
Tom
(Embedded image moved to file: pic01661.gif)Inactive hide details for Ian
Robinson <ian_robinson@uk.ibm.com>Ian Robinson <ian_robinson@uk.ibm.com>

                                                                           
                         Ian                                               
                         Robi                                              
                         nson                                              
                         <ian (Embedded image moved to file: pic00182.gif) 
                         _rob                                           To 
                         inso             (Embedded image moved to file:   
                         n@uk             pic14517.gif)                    
                         .ibm             Andrew Wilkinson3                
                         .com             <awilkinson@uk.ibm.com>          
                         >    (Embedded image moved to file: pic18831.gif) 
                                                                        cc 
                                          (Embedded image moved to file:   
                         03/0             pic30600.gif)                    
                         3/20             "Max Feingold"                   
                         06               <Max.Feingold@microsoft.com>,    
                         04:3             Thomas Freund/Austin/IBM@IBMUS,  
                         3 AM             ws-tx-editors@lists.oasis-open.o 
                                          rg                               
                              (Embedded image moved to file: pic26842.gif) 
                                                                   Subject 
                                          (Embedded image moved to file:   
                                          pic08672.gif)                    
                                          RE: [ws-tx-editors] Fw: Editors  
                                          instructions                     
                                                                           
                                                                           
                              (Embedded image moved to file: pic25928.gif) 
                                     (Embedded image moved to file:        
                                     pic03000.gif)                         
                                                                           
                                                                           







With regard to cross-references between the specs (e.g a [WSCOOR] ref in
WS-AT) there are 2 choices:
1. http://docs.oasis-open.org/ws-tx/wscoor/2006/03, which will resolve to a
RDDL doc
2. http://docs.oasis-open.org/ws-tx/wstx-wscoor-1.1-spec-wd-03.pdf which
will resolve to the specification document itself

#1 above is fairly common practice and more consistent with the existing
references.

Regards,
Ian Robinson
STSM, WebSphere Messaging and Transactions Architect
IBM Hursley Lab, UK
ian_robinson@uk.ibm.com



            Andrew
            Wilkinson3/UK/IBM
            @IBMGB                                                     To
                                      "Max Feingold"
            03/03/2006 10:14          <Max.Feingold@microsoft.com>,
                                      "Thomas Freund"
                                      <tjfreund@us.ibm.com>
                                                                       cc
                                      ws-tx-editors@lists.oasis-open.org
                                                                  Subject
                                      RE: [ws-tx-editors] Fw: Editors
                                      instructions










Thanks both.

I'll update the reference to WSCOOR too.

I had opted for a date of 2006/03 per Ian's recommendation on last week's
telecon:

"We also need to supply values for the yyyy/mm in the namespace.  We
should use 2006/03, based on the date we expect the CD or CDs to be
approved." -
http://www.oasis-open.org/apps/org/workgroup/ws-tx/download.php/16930/WS-TX_Minutes_2006_02_23.htm



So, just for the sake of clarity, that makes the three namespaces:

http://docs.oasis-open.org/ws-tx/wscoor/2006/03
http://docs.oasis-open.org/ws-tx/wsat/2006/03
http://docs.oasis-open.org/ws-tx/wsba/2006/03


Andy




"Max Feingold" <Max.Feingold@microsoft.com>
02/03/2006 20:19

To
"Thomas Freund" <tjfreund@us.ibm.com>,
<ws-tx-editors@lists.oasis-open.org>
cc

Subject
RE: [ws-tx-editors] Fw: Editors instructions






Andy:

My intention for WS-C was to update all references in the text, as Tom
indicates.

From: Thomas Freund [mailto:tjfreund@us.ibm.com]
Sent: Thu 3/2/2006 10:35 AM
To: ws-tx-editors@lists.oasis-open.org
Subject: Re: [ws-tx-editors] Fw: Editors instructions

Andrew,

I had intended to do a global change (including the refs --- and several
additional lines that seem to have been missed in the issue)

Tom
Andrew Wilkinson3 <awilkinson@uk.ibm.com>


Andrew Wilkinson3 <awilkinson@uk.ibm.com>
03/02/2006 11:42 AM



To

ws-tx-editors@lists.oasis-open.org

cc


Subject

Re: [ws-tx-editors] Fw: Editors instructions





Max, Tom

In the interests of consistency how far do you plan to go with the changes

for WS-Coor and WS-BA for issue 15?

I intend to update AT to describe coor with a namespace of
http://docs.oasis-open.org/ws-tx/wscoor/2006/03. At the moment I don't
intend to update the non-normative WSCOOR reference to refer to the new
specification; changing the list of authors and publication date etc. Does

this seem reasonable -  I don't feel strongly about this, just that it
would be good for all 3 specs to be updated similarly.

Thanks,
Andy




Ian Robinson/UK/IBM@IBMGB
02/03/2006 16:14

To
ws-tx-editors@lists.oasis-open.org
cc

Subject
[ws-tx-editors] Fw: Editors instructions










One further thing.
As a general rule it would help the TC if each WD had cumulative
change-tracking since the last approved draft (CD or PR). We have no
approved draft yet; the base draft with respect to which changes should be
tracked prior to our first CDs is the first drafts that used the OASIS
templates. In this case, please just do your best; if you haven't been
tracking changes in this way so far then just start doing so from now.

Regards,
Ian Robinson
STSM, WebSphere Messaging and Transactions Architect
IBM Hursley Lab, UK
ian_robinson@uk.ibm.com
----- Forwarded by Ian Robinson/UK/IBM on 02/03/2006 16:08 -----

           Ian
           Robinson/UK/IBM
                                                                      To

           02/03/2006 16:02          wstx-editors
                                                                      cc


                                                                 Subject

                                     Editors instructions









Hello Editors,

Per the discussion on the telecon last week, please can you get updated
drafts to the TC by EOD Tues 7 March.

Please use the following conventions to ensure consistency:

On the front page of each spec, please ensure you use the appropriate "doc
identifier", "location" and "Technical committee" name and correct form of
statustext.

1. Doc identifier value (this value should be on the line following
"Document Identifier" and in the page footer)
wstx-wscoor-1.1-spec-wd-03
wstx-wsat-1.1-spec-wd-03
wstx-wsba-1.1-spec-wd-03

2. Location value:
http://docs.oasis-open.org/ws-tx/wstx-wscoor-1.1-spec-wd-03.pdf
http://docs.oasis-open.org/ws-tx/wstx-wsat-1.1-spec-wd-03.pdf
http://docs.oasis-open.org/ws-tx/wstx-wsba-1.1-spec-wd-03.pdf

3. Technical committee
OASIS WS-TX TC
(Note upper case WS-TX)

4. Status.
The first line of the status section should state:
This document is published by the WS-TX TC as a ?working draft".

Please use a file name that is the doc identifier with a ".doc" file
extension e.g wstx-wsba-1.1-spec-wd-03.doc
We don't need to generate new PDFs yet. We will produce PDFs whenever the
TC adopts a new CD.

The issues that we want to incorporate in these drafts are listed below by
spec.

WS-Coordination

Issues: 4, 5, 6, 7, 8, 12, 13, 15, 17, (18-21)

WS-AtomicTransaction

Issues: 15, 17

WS-BusinessActivity

Issues: 7, 15, 17,



Regards,
Ian





pic01661.gif

pic00182.gif

pic14517.gif

pic18831.gif

pic30600.gif

pic26842.gif

pic08672.gif

pic25928.gif

pic03000.gif



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]