Re: Starter Documents for SAML Version 2.1

[Paul Knight <paul.knight@oasis-open.org>]

Hi Scott and all,

Attached please find the updated starter documents for SAML v2.1, with two-digit numbering in the titles and file names, etc.

As the TC defines additional Parts for the SAML V2.1 Work Product, please send in a request for each additional starter document.  I'll also be happy to modify the numbering for any of these existing Parts if needed.

I should also mention that the document Editor (probably you) does not need to maintain or update the titles or URIs of the items listed under "Additional artifacts."  That will be handled by TC Administration during each publication. I believe the only thing you'll need to adjust in the "Front Matter" (i.e., the material above the Table of Contents) is the text for the Abstract.

Best regards,

Paul

On Fri, Sep 14, 2012 at 1:23 PM, Paul Knight <paul.knight@oasis-open.org> wrote:

Hi Scott,

I'll be happy to prepare the docs with two-digit numbering..It will help the parts appear in order in file listings, etc.

(Instead of:

part1

part10

part2

part3

...)

No need to submit additional request form(s).

Should be back to you a bit later today...

Best regards,

Paul

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

On 9/14/12 1:10 PM, "Paul Knight" <paul.knight@oasis-open.org> wrote:
>
>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.

I figured.

>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.

I think that would be wise just in case if you want to use a fixed width
for the number.

>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.

Our problem is we aren't far enough into the process to know yet, and when
we did it originally, we didn't have numbered documents.

I don't mind having to adjust the metadata in the event I have to renumber.

Should I fill out a new ticket to request the two digit numbering or can
you take care of that?

>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.
>

Yes, we did that originally, that's nothing new.

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

Thanks.

-- Scott

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

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

Attachment: saml-v2.1-wd01-new1.zip
Description: Zip archive