Re: Starter Documents for SAML Version 2.1

(answers in-line below)

On Fri, Sep 14, 2012 at 12:47 PM, Cantor, Scott <cantor.2@osu.edu> wrote:

On 9/14/12 12:26 PM, "Paul Knight" <paul.knight@oasis-open.org> wrote:

>This is designed as a multi-part Work Product, with the following
>individual Work Product abbreviations:
>part1-overview
>part2-core
>part3-bindings
>part4-profiles
>part5-metadata
>part6-authn-context
>part7-sec-consider
>part8-conformance
>part9-glossary
>
>We expect this Work Product to be published at the following URIs:

We may be creating additional parts as we go along, I can't say for sure
yet. Assuming we do, is it a problem to renumber the later parts as we
proceed with the working drafts, or does that cause a problem for the
publication process?

I think it would be acceptable to renumber the Working Drafts before they are published as a Committee Specification Draft (CSD), but we wouldn't want to renumber after the initial publication. Additional parts could be added (with incremental numbers), but it would be very problematic to alter the existing part numbers after publication.

It sounds as though we might want to at least modify the initial documents to use a two-digit numbering scheme (part01, part02, etc.). Please let me know if you want to do this.

Renumbering is not very easy, since the Parts contain references to each other, as well as having metadata elements (document properties), footers, and front page formatting keyed to the Part number. It would be best to have it planned out as much as possible before going far... I'll be happy to produce a different set of starter documents if needed.

>For each WD revision, you will need to:
>1) increment the Working Draft revision (number) from 01 to 02, 03, 04
>etc., as successive Working Drafts are produced; the revision number
>needs to be updated at the top of the document in the stage identifier
>(Working Draft ##) and in the document identifier
> within the page footer.

Question regarding this: do we have to increment all the drafts and upload
as a unit, or can the working drafts float until the CSD stage? Meaning,
can the final step to CSD be approval of differently numbered working
drafts of the various parts?

It's fine to have varying WD numbers submitted together, to be published as a single CSD with a common CSD number. It will be really important to get all the parts together into a single ZIP file (including all schemas, etc.) and have the TC vote on the ZIP file as a whole.

Thanks very much for the quick turnaround, I know it's a lot of documents.

You're welcome... and I'll be happy to prepare a modified set if needed.

Best regards,

Paul

-- Scott

--
Paul Knight - Tel: +1 781-861-1013
OASIS - Advancing open standards for the information society
Document Process Analyst

security-services message