Re: Fixing incorrect links in IMI SAML profile documents

[Mary McRae <mary.mcrae@oasis-open.org>]

Hi Mike,

  We (TC Admin) automatically update CDs upon successful completion of a CS ballot to CS status. We do it for a number of reasons: first, it's quicker for all involved, and second, it ensures that links are properly updated and that nothing other than what is allowed to be updated is changed.

  Thank you for picking up on the RDDL errors! I will swap those files out. In the actual specs, however, you can't update those references since you didn't include a designated cross reference as part of the motion to approve as CS. The TC Process is very specific about exactly what can be changed upon approval at any level:

"Any change made to a specification requires a new version or revision number, except for changes made to (a) the approval status, (b) the date, (c) the URIs of the specification as appropriate, (d) the running header/footer, and (e) any approved Designated Cross-Reference Changes, all of which must be made after the approval of the specification as a Committee Draft, Committee Specification, or OASIS Standard."

If you want the cross-references to match, you can request new ballots to be run, this time including a designated cross-reference motion for each. If the TC is interested in doing that and would like further assistance crafting the actual motion text, just let me know. Or, if the specs will be submitted for OS ballot, the cross-reference motion could be included at that time so the resulting OSs would match.

Thanks!

Mary

On Thu, Sep 2, 2010 at 7:57 PM, Mike Jones <Michael.Jones@microsoft.com> wrote:

First, in the RDDL documents, all the specification links are wrong.  Here’s diffs between the old and new ones:

 

c:\mbj\DSG\IMI TC>diff "imi SAML cs docs as posted 31-Aug-10" imi-saml1.1-profile-rddl-201007-cs-01.html

76,77c76,77

<                               <a href=""http://docs.oasis-open.org/imi/identity/cd/imi-saml1.1-profile-cs-01.doc">

<                               http://docs.oasis-open.org/imi/identity/cd/imi-saml1.1-profile-cs-01.doc</a> &nbsp; </p>

---

>                               <a href=""http://docs.oasis-open.org/imi/identity/cs/imi-saml1.1-profile-cs-01.doc">

>                               http://docs.oasis-open.org/imi/identity/cs/imi-saml1.1-profile-cs-01.doc</a> &nbsp; </p>

93c93

<                       <a href=""http://docs.oasis-open.org/imi/identity/cd/imi-saml1.1-profile-cs-01.doc">

---

>                       <a href=""http://docs.oasis-open.org/imi/identity/cs/imi-saml1.1-profile-cs-01.doc">

96c96

<                       <a href=""http://docs.oasis-open.org/imi/identity/cd/imi-saml1.1-profile-cs-01.pdf">

---

>                       <a href=""http://docs.oasis-open.org/imi/identity/cs/imi-saml1.1-profile-cs-01.pdf">

99c99

<                       <a href=""http://docs.oasis-open.org/imi/identity/cd/imi-saml1.1-profile-cs-01.html">

---

>                       <a href=""http://docs.oasis-open.org/imi/identity/cs/imi-saml1.1-profile-cs-01.html">

 

c:\mbj\DSG\IMI TC>diff "imi SAML cs docs as posted 31-Aug-10" imi-saml2.0-profile-rddl-201007-cs-01.html

76,77c76,77

<                               <a href=""http://docs.oasis-open.org/imi/identity/cd/imi-saml2.0-profile-cs-01.doc">

<                               http://docs.oasis-open.org/imi/identity/cd/imi-saml2.0-profile-cs-01.doc</a> &nbsp; </p>

---

>                               <a href=""http://docs.oasis-open.org/imi/identity/cs/imi-saml2.0-profile-cs-01.doc">

>                               http://docs.oasis-open.org/imi/identity/cs/imi-saml2.0-profile-cs-01.doc</a> &nbsp; </p>

93c93

<                       <a href=""http://docs.oasis-open.org/imi/identity/cd/imi-saml2.0-profile-cs-01.doc">

---

>                       <a href=""http://docs.oasis-open.org/imi/identity/cs/imi-saml2.0-profile-cs-01.doc">

96c96

<                       <a href=""http://docs.oasis-open.org/imi/identity/cd/imi-saml2.0-profile-cs-01.pdf">

---

>                       <a href=""http://docs.oasis-open.org/imi/identity/cs/imi-saml2.0-profile-cs-01.pdf">

99c99

<                       <a href=""http://docs.oasis-open.org/imi/identity/cd/imi-saml2.0-profile-cs-01.html">

---

>                       <a href=""http://docs.oasis-open.org/imi/identity/cs/imi-saml2.0-profile-cs-01.html">

 

In imi-saml1.1-profile-cs-01.doc, there are two incorrect passages that weren’t present in the versions I submitted, so I’m not sure how they crept in.  It looks like they were copied from the previous draft.  Specifically, in the “Related work” section on p. 1, the last related specification in the posted draft reads:

·         OASIS Committee Draft, “SAML V2.0 Information Card Token Profile Version 1.0”, July 2010.  http://docs.oasis-open.org/imi/identity/cd/imi-saml2.0-profile-cd-03.pdf

when it should say:

·         OASIS Committee Specification, “SAML V2.0 Information Card Token Profile Version 1.0”, July 2010.  http://docs.oasis-open.org/imi/identity/cs/imi-saml2.0-profile-cs-01.pdf

Likewise, in Section 1.4, the last non-normative reference in the posted draft reads:

[SAML2IMI]

OASIS Committee Draft, “SAML V2.0 Information Card Token Profile Version 1.0”, July 2010.  http://docs.oasis-open.org/imi/identity/cd/imi-saml2.0-profile-cd-03.pdf

when it should say:

[SAML2IMI]

OASIS Committee Specification, “SAML V2.0 Information Card Token Profile Version 1.0”, July 2010.  http://docs.oasis-open.org/imi/identity/cs/imi-saml2.0-profile-cs-01.pdf

 

The corresponding errors are also present in the posted version of In imi-saml2.0-profile-cs-01.doc.  In the “Related work” section on p. 1, the last related specification in the posted draft reads:

·         OASIS Committee Draft, “SAML V1.1 Information Card Token Profile Version 1.0”, July 2010.  http://docs.oasis-open.org/imi/identity/cd/imi-saml1.1-profile-cd-02.pdf

when it should say:

·         OASIS Committee Specification, “SAML V1.1 Information Card Token Profile Version 1.0”, July 2010.  http://docs.oasis-open.org/imi/identity/cs/imi-saml1.1-profile-cs-01.pdf

Likewise, in Section 1.4, the last non-normative reference in the posted draft reads:

[SAML1.1IMI]          OASIS Committee Draft, “SAML V1.1 Information Card Token Profile Version 1.0”, July 2010.  http://docs.oasis-open.org/imi/identity/cd/imi-saml1.1-profile-cd-02.pdf

when it should say:

[SAML1.1IMI]          OASIS Committee Specification, “SAML V1.1 Information Card Token Profile Version 1.0”, July 2010.  http://docs.oasis-open.org/imi/identity/cs/imi-saml1.1-profile-cs-01.pdf

 

The other change made to both documents, that also looks like it was a result of copying from the previous drafts, rather than using the ones that I submitted, was deletion of this line of the revision history in appendix B:

cs-01

21 July 2010

Michael B. Jones

Committee Specification.

 

Picking up the versions of the RDDL, doc, pdf, and HTML files that I uploaded this morning will address all of these issues and introduce no other changes.

 

                                                                Thanks again,

                                                                -- Mike

 

From: Mary McRae [mailto:mary.mcrae@oasis-open.org]
Sent: Thursday, September 02, 2010 4:29 PM
To: Mike Jones
Cc: imi@lists.oasis-open.org
Subject: Re: Fixing incorrect links in IMI SAML profile documents

 

Hi Mike,

 

  Can you tell me where the problems are with the uploaded specs? I'm pretty sure Kim prepared these and I'm not seeing any problems. 

 

Thanks!

 

Mary

On Thu, Sep 2, 2010 at 12:54 PM, Mike Jones <Michael.Jones@microsoft.com> wrote:

Hi Mary,

 

I have to apologize that, in reviewing the posted IMI SAML profile docs, I found that there are incorrect links that resulted from incomplete editing on my part.  In particular, there are numerous links like this one http://docs.oasis-open.org/imi/identity/cd/imi-saml1.1-profile-cs-01.html, which should have been http://docs.oasis-open.org/imi/identity/cs/imi-saml1.1-profile-cs-01.html.  (The difference is the “cs” in “imi/identity/cs”, rather than the incorrect “cd”.)  I noticed that you corrected some of these when you posted the docs (thanks!) but some of them still remain.

 

I have uploaded new versions of all the docs (all were affected).  Can you please update the posted versions with the corrected versions that I just uploaded?  For simplicity, you can pick up a zip file containing all of them at http://www.oasis-open.org/committees/download.php/39209/imi_saml_profiles_committee_specifications.zip.

 

                                                            Thanks again!

                                                            -- Mike

 

--
Mary P McRae

OASIS
Director, Standards Development

TC Administrator

Member Section Administrator

OASIS: Advancing open standards for the information society
email: mary.mcrae@oasis-open.org
phone: 603.232.9090

 

--
Mary P McRae

OASIS
Director, Standards Development

TC Administrator

Member Section Administrator

OASIS: Advancing open standards for the information society
email: mary.mcrae@oasis-open.org
phone: 603.232.9090