Re: [imi] work product review

Mary

On Mon, Feb 22, 2010 at 12:50 PM, Mike Jones <Michael.Jones@microsoft.com> wrote:

Thanks for pointing these issues out. I’ll address them and send you updated docs.

                                                            -- Mike

From: Mary McRae [mailto:mary.mcrae@oasis-open.org]
Sent: Sunday, February 21, 2010 10:26 PM
To: imi@lists.oasis-open.org
Subject: [imi] work product review

The following issues have been identified in the submitted work products and must be corrected before they can be uploaded to docs.oasis-open.org and a public review announced:

SAML V2.0 Information Card Token Profile Version 1.0

1. Specification URIs:

This Version:

  The path includes 'ed'; I'm guessing this is intended to point to something akin to a Working Draft. Note that the TC Process clearly identifies the stages of a document as follows: working draft (wd), committee draft (cd), public review draft (pr), committee specification (cs), and OASIS standard (os). There is no such stage as 'ed'.

Previous Version:

  As this is the first time this document has been requested to be uploaded, it should state 'N/A'. the URIs specified in this section do not resolve (and won't, since we only upload approved documents to docs.oasis-open.org)

2. Namespaces:

This section has been removed from the cover page, but the following reference is given in 2.1:

http://docs.oasis-open.org/imi/ns/token/saml2/200908

Note that ns is reserved for OASIS namespaces, all of which must be identified on the cover page of a document and accompanied by a namespace document that corresponds to the template found at docs.oasis-open.org/templates

3. References:

WSTrust14 reference does not meet the OASIS citation link requirements

SAML1.1IMI reference does not conform to the OASIS citation format/link requirements.

------

SAML V1.1 Information Card Token Profile Version 1.0

1. Specification URIs:

This Version:

  The path includes 'ed'; I'm guessing this is intended to point to something akin to a Working Draft. Note that the TC Process clearly identifies the stages of a document as follows: working draft (wd), committee draft (cd), public review draft (pr), committee specification (cs), and OASIS standard (os). There is no such stage as 'ed'.

Previous Version:

  As this is the first time this document has been requested to be uploaded, it should state 'N/A'. the URIs specified in this section do not resolve (and won't, since we only upload approved documents to docs.oasis-open.org)

2. Namespaces:

This section has been removed from the cover page, but the following reference is given in 2.1:

http://docs.oasis-open.org/imi/ns/token/saml1_1/200912

Note that ns is reserved for OASIS namespaces, all of which must be identified on the cover page of a document and accompanied by a namespace document that corresponds to the template found at docs.oasis-open.org/templates

3. References

The references to OASIS TC documents do not conform to the OASIS citation format/link requirements.

4. Invalid URI:

In section 2.4.1 the following URI is given:

http://docs.oasis-open.org/wss/oasis-wss-saml-token-profile-1.1#SAMLV1.1

That is an invalid reference.

Please make the necessary corrections, re-approve the documents, and re-submit for public review.

Regards,

Mary

Mary P McRae

Director, Standards Development

Technical Committee Administrator

OASIS: Advancing open standards for the information society

email: mary.mcrae@oasis-open.org

web: www.oasis-open.org

twitter: @fiberartisan #oasisopen

phone: 1.603.232.9090

Standards are like parachutes: they work best when they're open.

--
Mary P McRae
Director of Standards Development and TC Administration, OASIS
mary.mcrae@oasis-open.org
voip: 603.232.9090

imi message