Next in thread →
Next in month →
RE: [ws-rx-editors] [Fwd: Re: Help please [about date-less/version-lessspec URIs]]
Mary, could you take a look at the latest docs at: http://www.oasis-open.org/apps/org/workgroup/ws-rx-editors/documents.php in the CD6 folder to see if they look ok. In particular, could you look at the trademarks and see if I got those right. I tried to make all of the edits you and Robin suggested. thanks -Doug ______________________________________________________ STSM | Web Services Architect | IBM Software Group (919) 254-6905 | IBM T/L 444-6905 | "Mary McRae" <> Sent by: Mary McRae <> 02/23/2007 04:52 PM Please respond to <> To Doug Davis/Raleigh/IBM@IBMUS, "'Paul Fremantle'" <> cc <>, <> Subject RE: [ws-rx-editors] [Fwd: Re: Help please [about date-less/version-less spec URIs]] Hi Doug, Looks good. Yes, it's okay to include namespace and conformance in section 1; note that with the upcoming changes to the TC Process there will be a new section created for conformance requirements but these docs will be through the cycle before those changes go into effect. Multiple columns for acknowledgements is fine. A couple of things: Latest Approved Version URI: This is intended to act in the same manner as "Latest Version URI" except that it would skip over any working drafts or revisions that had not yet been approved by the TC (i.e. CD 01 R 02 is unofficial until approved as CD 02) lines 56 and 62: add a trailing slash to URI All URIs should be created as Hyperlinks so that a reader can actually navigate to the location directly from the document. If you highlight the link itself, then go to "insert" -> Hyperlink it will bring up a dialog box. By default it should create a link to the same text that you highlighted. Just save and you now have a navigable link. Trademarks - according to the policy, all terms related to the specification and the TC are to be listed - this would include "WS-ReliableMessaging", wsrm, WS-RX, etc. That's everything that's jumping out at me. Regards, Mary From: Doug Davis [mailto:] Sent: Tuesday, February 20, 2007 7:44 PM To: Paul Fremantle Cc: ; ; Subject: Re: [ws-rx-editors] [Fwd: Re: Help please [about date-less/version-less spec URIs]] All, I've gone thru the RM spec and reformatted things per the latest template. In terms of edits to the doc, I tried to not do any textual changes with the exception of the following: - renamed it CD06 - should probably have been optimistic and called it CS :-) - latest URI is now: http://docs.oasis-open.org/ws-rx/wsrm/wsrm.pdf Robin - is this an ok URI? - moved the normative and non-normative sections to the top of the doc - per the template - Robin/Mary - is it ok that we have other sections (like 'conformance' and 'namespace' in section 1 ?) - reformatting the contributors section - each person got their own line now - Robin/Mary - can we do multiple-columns or does it have to be this way? Its a lot of space. The doc is here: http://www.oasis-open.org/apps/org/workgroup/ws-rx-editors/download.php/22537/wsrm-1.1-spec-cd-06.doc Mary/Robin - could I ask you guys to look over this doc to see if it conforms to the new template? I tried to match all of the sections and formatting styles as best I could. Editors - please give this doc a scan. Things to look for: - At times I had to manually re-add some text/URLs (like in the references sections) to get things to format correctly. - And watch for variables in the examplars (e.g. xs:string) not being in italics - paragraph numbering and bullets - tried to make sure we were consistent across the entire doc w.r.t. indenting etc... - missing hyper-links - examples and code snippets were removed on purpose, but others should probably be there. - check bookmarks - I had to redo them all by hand - for some reason they were all messed up after I moved the (non) normative sections Once people look this over and are ok with it, then I'll move on to RMP and MC. thanks -Doug ______________________________________________________ STSM | Web Services Architect | IBM Software Group (919) 254-6905 | IBM T/L 444-6905 | Paul Fremantle <> 02/19/2007 10:51 AM To "" <> cc Subject [ws-rx-editors] [Fwd: Re: Help please [about date-less/version-less spec URIs]] FYI here is Robin's advice for our URIs. Paul -------- Original Message -------- Subject: Re: Help please [about date-less/version-less spec URIs] Date: Mon, 19 Feb 2007 09:42:08 -0500 (EST) From: Robin Cover <> To: Paul Fremantle <> CC: Robin Cover <> References: <> Paul, Re: > I would have thought that we'd want a URL that was date-less as well as > version-less. I apologize for failing to respond to your request for advice in a timely manner. The request is quite reasonable, as seems to be proven by the successful W3C practice of publishing its recommendation-track specifications at URIs like: Latest version: http://www.w3.org/TR/xquery-semantics/ Latest version: http://www.w3.org/TR/ws-addr-core Latest version: http://www.w3.org/TR/xkms2/ Latest version: http://www.w3.org/TR/soap12-part0/ Initially, when I saw the proposal for "Something like" > http://docs.oasis-open.org/ws-rx/wsrm > http://docs.oasis-open.org/ws-rx/wsrmp > http://docs.oasis-open.org/ws-rx/wsmc I was stumped, because we have a commitment to use the "directory URIs" [slash "/" and slashless ""] as identifiers for directory listings, as in this current example: http://docs.oasis-open.org/ws-rx/wsrm/ http://docs.oasis-open.org/ws-rx/wsrm *That index listing is ugly now, but we have plans to make it more usable. The Naming Guidelines do require that specifications be assigned a "Latest Version:" URI, which is a URI alias pointing to the resource that is the current/latest at any point in time. See: "Specification URIs" http://docs.oasis-open.org/specGuidelines/namingGuidelines/metadata.html#specURIs The OASIS membership provided clear feedback (ASIS review) that we should impose no single format for the "Latest Version:" URI -- allowing the TCs to select something reasonable, suitable to their needs and sensibilities. Some of the examples provided for "Latest Version:" URI are dateless, as you can see in the section "Specification URIs" cited above: http://docs.oasis-open.org/exampleTC/fruitMarkup/v2/fruit2.html No examples are "version-less" though -- in part, because some reviewers asked that we NOT assume genetic continuity between [e.g.] DITA 1.0 and DITA 3.0, such as might be implied by a generic/version-agnostic URI like this, which otherwise could serve as the latest/dateless/version-less URI for all 'DITA' specs. http://docs.oasis-open.org/dita/TR Their argument was that an entirely different group of people might work on "DITA 3.0" than worked on "DITA 1.0", the the DITA-3 people might not want to be forced to use a URI that implies "DITA 3.2" is the "latest" version of the DITA 1.0 product, in close continuity with it. We use the term "Version" in a fairly specific way in connection with identifying a specification version: http://docs.oasis-open.org/specGuidelines/namingGuidelines/metadata.html#version I *do* encourage you to bring up this issue with the WS-RX TC editors, however, since selection of a "Latest Version:" URI is needed for wsrm, wsrmp, and wsmc. In the WS-ReliableMessaging 1.1 spec here: http://docs.oasis-open.org/ws-rx/wsrm/200702/wsrm-1.1-spec-cd-05.pdf the text says: Latest Version: http://docs.oasis-open.org/ws-rx/wsrm/200702 and that's not what we have in mind; that's the NS URI. The spec title page has a dsignated place for the associated NS URI(s), e.g., Declared XML Namespaces: http://docs.oasis-open.org/ws-rx/wsrm/200702 I'll try to make myself available, if needed, to help think through (or review candidates for) possible Latest Version URIs suitable for the WS-RX TC's specs. Caveats: * The TAB and Board are considering options for a method of using the concept/term "normative" [or "official"] format (XHTML vs. PDF vs. EditableSource). The results might lead to a change in the Naming Guidelines so that there would be only one "Latest Version:" URI printed on a spec title page, not 2-3 URIs, as in: Latest Version: http://example.com/fishing/fishML.pdf http://example.com/fishing/fishML.doc http://example.com/fishing/fishML.html * The OASIS IT programming team is preparing a new URI aliasing tool (serving some of the functions of Apache mod_alias, mod_rewrite, etc.) to give us greater flexibility in handling the URI aliasing mechanisms [server-side URI rewrite in addition to client-side redirect], but it's not certain when that will be activated. ***Privately***: see a prototype here: http://docs3.oasis-open.org/ws-rx/ Please don't publish that -- it might be buggy. Again, I sincerely apologize for not responding on time; please forgive me. Best wishes. Robin Cover ------------- On Mon, 12 Feb 2007, Paul Fremantle wrote: > Robin > > Can you advise us on this one please? > > Paul > > -------- Original Message -------- > Subject: RE: [ws-rx-editors] RE: CD5.3 > Date: Mon, 12 Feb 2007 07:19:01 -0500 > From: Doug Davis <> > To: Marc Goodner <> > CC: 'Mary McRae' <>, > <>, Paul Fremantle <>, 'Robin > Cover' <>, > <> > > > > > I would have thought that we'd want a URL that was date-less as well as > version-less. Something like: > http://docs.oasis-open.org/ws-rx/wsrm > http://docs.oasis-open.org/ws-rx/wsrmp > http://docs.oasis-open.org/ws-rx/wsmc > > That way even if we have a v.Next the URL would still not need to > change. Mary - is this possible? > > thanks > -Doug > ______________________________________________________ > STSM | Web Services Architect | IBM Software Group > (919) 254-6905 | IBM T/L 444-6905 | > > > *Marc Goodner <>* > > 02/11/2007 10:40 PM > > > To > Paul Fremantle <>, "" > <> > cc > Doug Davis/Raleigh/IBM@IBMUS, "'Mary McRae'" <>, > "" > <>, "'Robin Cover'" > <> > Subject > RE: [ws-rx-editors] RE: CD5.3 > > > > > > > > > My reading is that Dug has made all of the requested changes except one > we are still discussing. The open issue is what to use for the latest > link in the doc. > > My recommendation is to just use the current namespace. Mary has > suggested a permanent latest URI could be assigned for this use. I'm not > inherently opposed to that but I'd prefer some more discussion before > putting it into practice. > > -----Original Message----- > From: Paul Fremantle [mailto:] > Sent: Sunday, February 11, 2007 7:30 PM > To: > Cc: Marc Goodner; 'Doug Davis'; 'Mary McRae'; > ; 'Robin Cover' > Subject: Re: [ws-rx-editors] RE: CD5.3 > > I'd like to thank Marc, Doug and Mary for all your efforts this weekend. > > Can anyone give me a brief status update? I've seen a ton of useful > messages but I haven't quite figured out what is still needed before the PR. > > Thanks > Paul > > Mary McRae wrote: > > We can also invent another URI to be used - like > > docs.oasis-open.org/ws-rx/wsrm/v1.1/wsrm-v1.1.doc etc. - that way even > > if the date changes we're still talking about the latest version of the > > 1.1 spec ... > > > > m > > > > > ------------------------------------------------------------------------ > > *From:* Marc Goodner [mailto:] > > *Sent:* Sunday, February 11, 2007 9:18 PM > > *To:* Doug Davis; > > *Cc:* 'Mary McRae'; > > *Subject:* RE: [ws-rx-editors] RE: CD5.3 > > > > So on 2, yeah we don't have anything like that. I think the best we > > can do is a link to the namespace as that could eventually contain > > the previous/latest links there. The only other immediate > > alternative I can think of would be the Public TC page. > > > > > > > > My vote for now would be to use the namespace. The reason is that if > > we progress with the same namespace from this PR, and I'm pretty > > hopeful we will, then the CS will be in that location with a link to > > the previous CD for the same namespace. That seems to best satisfy > > the intent. > > > > > > > > *From:* Doug Davis [mailto:] > > *Sent:* Sunday, February 11, 2007 5:38 PM > > *To:* > > *Cc:* 'Mary McRae'; Marc Goodner; > > *Subject:* RE: [ws-rx-editors] RE: CD5.3 > > > > > > > > > > 1. I'll remove the [insert...] since, as Marc said, I don't think we > > have any. > > 2. The guideline says: > > A bookmarkable, version-agnostic, generic URI serving as a URI alias > > which is always associated with the latest/current specification > > instance, thus having a changing referent; it serves to identify and > > directly locate each successive published instance of a developing > > specification, through time [Label: Latest Version] > > Do we have a URL like that? As far as I know all of our URLs have > > dates in them. Can Oasis assign us a non-dated set of URLs? > > 3. Done - as much as I could anyway :-) > > > > Latest zip is here: > > > http://www.oasis-open.org/apps/org/workgroup/ws-rx-editors/download.php/22331/CD05.zip > > > > (you guys are probably sick of me sending huge zip files) > > Will replace the individual files in the CD5 folder once people 'ok' > > it but I think I still need those static URLs mentioned in #2. > > > > thanks > > -Doug > > ______________________________________________________ > > STSM | Web Services Architect | IBM Software Group > > (919) 254-6905 | IBM T/L 444-6905 | > > > > *"Mary McRae" <>* > > Sent by: Mary McRae <> > > > > 02/11/2007 07:54 PM > > > > Please respond to > > <> > > > > > > > > To > > > > > > > > Doug Davis/Raleigh/IBM@IBMUS, "'Marc Goodner'" > <> > > > > cc > > > > > > > > "'Mary McRae'" <>, > > <> > > > > Subject > > > > > > > > RE: [ws-rx-editors] RE: CD5.3 > > > > > > > > > > > > > > > > > > Before you do that ;-) > > > > 1. in all three spec files -- pay attention to the last para of the > > Notices section. It refers to OASIS' new Trademark policy. In the > > first line you'll see "[insert specific trademarked names, > > abbreviations, etc. here]" - any terms that the TC believes should > > be trademarked should be listed there and the boilerplate text > removed. > > > > 2. also, for "latest version" the intent is to use a URI that will > > always bring up the most recent copy of the spec (see samples in > > naming guidelines documents). Oops - just found another bad link on > > the templates page. > > > http://docs.oasis-open.org/templates/OASISSpecificationTemplateGuidelines.html > > section 3.4.3 or here: > > > http://docs.oasis-open.org/specGuidelines/namingGuidelines/metadata.html#specURIs > > > > > > 3. I apparently also messed up when I created the new templates for > > OO (and possibly Word). There were supposed to be two more > > categories on the cover page between Editors and Abstract: > > Related Work > > and > > Declared XML Namespaces > > (can be seen here: > > > http://docs.oasis-open.org/templates/OASISSpecificationTemplateV3.0.html) > > > > > > No penalties for not including #3, but bonus points awarded if you > > do ;-) > > > > I'm going to go watch the Grammys ... I think you guys have it under > > control and we'll be all set for announcement tomorrow. > > > > m > > > > > ------------------------------------------------------------------------ > > > > *From:* Doug Davis [mailto:] * > > Sent:* Sunday, February 11, 2007 7:29 PM* > > To:* Marc Goodner* > > Cc:* Mary McRae; ; > > * > > Subject:* RE: [ws-rx-editors] RE: CD5.3 > > > > > > Actually, I was hoping you might be able to generate new HTML by > > importing it into Word :-) > > > > thanks > > -Doug > > ______________________________________________________ > > STSM | Web Services Architect | IBM Software Group > > (919) 254-6905 | IBM T/L 444-6905 | > > > > *Marc Goodner <>* > > > > 02/11/2007 07:22 PM > > > > > > > > > > > > To > > > > > > > > Doug Davis/Raleigh/IBM@IBMUS, "" > > <> > > > > cc > > > > > > > > Mary McRae <>, > > "" > > <> > > > > Subject > > > > > > > > RE: [ws-rx-editors] RE: CD5.3 > > > > > > > > > > > > > > > > > > > > Thanks for the quick turnaround on the doc Dug. Mary, thanks a ton > > for staying engaged with us over the weekend. > > > > A quick scan and this looks good to me. It looks like the correct > > Notices now, but I defer to Mary on that. > > > > This one doesn't have the HTML in it. We're we just going to update > > the previous generated HTML by hand? > > * > > From:* Doug Davis [mailto:] * > > Sent:* Sunday, February 11, 2007 3:17 PM* > > To:* * > > Cc:* Mary McRae; * > > Subject:* RE: [ws-rx-editors] RE: CD5.3 > > > > > > *********************** > > Warning: Your file, CD05.zip, contains more than 32 files after > > decompression and cannot be scanned. > > *********************** > > > > > > > > ok - let's give this one a try. > > > > > > thanks > > -Doug > > ______________________________________________________ > > STSM | Web Services Architect | IBM Software Group > > (919) 254-6905 | IBM T/L 444-6905 | > > > > *"Mary McRae" <>* > > Sent by: Mary McRae <> > > > > 02/11/2007 06:05 PM > > > > > > > > Please respond to > > <> > > > > > > > > > > > > To > > > > > > > > Doug Davis/Raleigh/IBM@IBMUS > > > > cc > > > > > > > > <> > > > > Subject > > > > > > > > RE: [ws-rx-editors] RE: CD5.3 > > > > > > > > > > > > > > > > > > > > > > > > > > > > Almost - new Copyright line says: > > Copyright (c) OASIS(r) 1993-2007. All Rights Reserved. OASIS > trademark, > > IPR and other policies apply. > > > > And then you'll need to make sure that it's the same in both the > > spec and the schema/wsdl themselves. > > > > m > > > > > > > > > ------------------------------------------------------------------------ > > > > > > * > > From:* Doug Davis [mailto:] * > > Sent:* Sunday, February 11, 2007 5:03 PM* > > To:* * > > Cc:* * > > Subject:* [ws-rx-editors] RE: CD5.3* > > Importance:* High > > > > > > Mary, > > am I correct in assuming that if I replace: > > <!--> OASIS takes no position regarding the validity or scope > of any > > intellectual prop > > erty or other rights that might be claimed to pertain to the > > implementation or u > > se of the technology described in this document or the extent to > > which any licen > > se under such rights might or might not be available; neither does > > it represent > > that it has made any effort to identify any such rights. Information > > on OASIS's > > procedures with respect to rights in OASIS specifications can be > > found at the OA > > SIS website. Copies of claims of rights made available for > > publication and any a > > ssurances of licenses to be made available, or the result of an > > attempt made to > > obtain a general license or permission for the use of such > > proprietary rights by > > implementors or users of this specification, can be obtained from > > the OASIS Exe > > cutive Director. > > OASIS invites any interested party to bring to its attention any > > copyrights, pat > > ents or patent applications, or other proprietary rights which may > > cover technol > > ogy that may be required to implement this specification. Please > > address the inf > > ormation to the OASIS Executive Director. > > Copyright (c) OASIS Open 2002-2007. All Rights Reserved. > > This document and translations of it may be copied and furnished to > > others, and > > derivative works that comment on or otherwise explain it or assist > > in its implem > > entation may be prepared, copied, published and distributed, in > > whole or in part > > , without restriction of any kind, provided that the above copyright > > notice and > > this paragraph are included on all such copies and derivative works. > > However, th > > is document itself does not be modified in any way, such as by > > removing the copy > > right notice or references to OASIS, except as needed for the > > purpose of develop > > ing OASIS specifications, in which case the procedures for > > copyrights defined in > > the OASIS Intellectual Property Rights document must be followed, or > > as require > > d to translate it into languages other than English. > > The limited permissions granted above are perpetual and will not be > > revoked by O > > ASIS or its successors or assigns. > > This document and the information contained herein is provided on an > > "AS IS" bas > > is and OASIS DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING > > BUT NOT LIM > > ITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT > > INFRINGE AN > > Y RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR > > A PARTICULA > > R PURPOSE. > > --> > > > > with just: > > > > <!-- Copyright (c) OASIS Open 2002-2007. All Rights Reserved. --> > > > > That'd we'd be ok? > > > > thanks > > -Doug > > ______________________________________________________ > > STSM | Web Services Architect | IBM Software Group > > (919) 254-6905 | IBM T/L 444-6905 | > > > > *"Mary McRae" <>* > > Sent by: Mary McRae <> > > > > 02/11/2007 04:47 PM > > > > > > > > Please respond to > > <> > > > > > > > > > > > > > > > > To > > > > > > > > Doug Davis/Raleigh/IBM@IBMUS, <> > > > > cc > > > > > > > > Subject > > > > > > > > RE: CD5.3 > > > > > > > > > > > > > > > > > > > > > > > > > > > > > > Hi Doug, > > > > I haven't unzipped yet, but the schema / wsdl *do* need the Notices > > section that's inserted as a comment at the beginning of the files > > changed from the legacy IPR policy language to the 4-15-2005 policy > > language ... I'm willing to go the extra mile to get this out by end > > of day Monday since you're working hard to get everything > accomplished. > > > > Mary > > > > > > > > > ------------------------------------------------------------------------ > > > > > > * > > From:* Doug Davis [mailto:] * > > Sent:* Sunday, February 11, 2007 10:26 AM* > > To:* * > > Cc:* * > > Subject:* CD5.3* > > Importance:* High > > > > *********************** > > Warning: Your file, CD05.zip, contains more than 32 files after > > decompression and cannot be scanned. > > *********************** > > > > > > > > > > > > Editors: > > Here's CD5.3 with the changes Mary wanted. I did not update the > > schema/wsdl as that was just a suggestion and I wanted to keep the > > diffs as small as possible. > > Take a look and see if all looks well. > > > > > > thanks > > -Doug > > ______________________________________________________ > > STSM | Web Services Architect | IBM Software Group > > (919) 254-6905 | IBM T/L 444-6905 | > > > > -- > Paul Fremantle > VP/Technology and Partnerships, WSO2 > OASIS WS-RX TC Co-chair > > http://bloglines.com/blog/paulfremantle > > (646) 290 8050 > > "Oxygenating the Web Service Platform", www.wso2.com > > > > -- > Paul Fremantle > VP/Technology and Partnerships, WSO2 > OASIS WS-RX TC Co-chair > > http://bloglines.com/blog/paulfremantle > > (646) 290 8050 > > "Oxygenating the Web Service Platform", www.wso2.com > > -- Paul Fremantle VP/Technology and Partnerships, WSO2 OASIS WS-RX TC Co-chair http://bloglines.com/blog/paulfremantle (646) 290 8050 "Oxygenating the Web Service Platform", www.wso2.com
Next in thread →
Next in month →