oasis-tcs / csaf

OASIS CSAF TC: Supporting version control for Work Product artifacts developed by members of TC, including prose specifications and secondary artifacts like meeting minutes and productivity code
https://github.com/oasis-tcs/csaf
Other
148 stars 39 forks source link

Motion template to initiate the public review of the first CSAF v2.0 CSD 01 / CSDPR 01 #331

Closed sthagen closed 3 years ago

sthagen commented 3 years ago

@santosomar, @chet-ensign I hereby suggest the following motion template in the case the TC likes to initiate the public review of the first CSAF v2.0 Committee Specification Draft in today‘s meeting:

I move that the TC approve CSAF Version 2.0 Working Draft and all associated artifacts packaged together in as a Committee Specification Draft 01 and designate the markdown version of the specification as authoritative and direct the Chair supported by the Editors to perform any tasks as required by TC Admin to facilitate that issuance. I further move that the TC approve submitting CSAF Version 2.0 Committee Specification Draft 01 for 30 days public review and direct the Chair perform any tasks as required by TC Admin to facilitate that issuance.

My suggestion is to agree during the meeting on the URLs by just copying the URL of the editor draft and generate a zipfile of the three schema files and the markdown file as service for TC Admins. The designation of the normative format is relevant when TC Admin adds the generated HTML and PDF variants to the markdown source for publication and review.

The current URLs for the 4 artifacts we submit to TC Admins would be:

Unfortunately I currently do not have access to a machine to generate a zip archive and upload this here, but any note on the four specific URLs should be sufficiently safe to generate a zip file after the meeting.

Originally posted by @sthagen in https://github.com/oasis-tcs/csaf/issues/329#issuecomment-888418320

chet-ensign commented 3 years ago

Thanks Stefan - that motion works perfectly!

On Wed, Jul 28, 2021 at 11:47 AM Stefan Hagen @.***> wrote:

@santosomar https://github.com/santosomar, @chet-ensign https://github.com/chet-ensign I hereby suggest the following motion template in the case the TC likes to initiate the public review of the first CSAF v2.0 Committee Specification Draft in today‘s meeting:

I move that the TC approve CSAF Version 2.0 Working Draft and all associated artifacts packaged together in as a Committee Specification Draft 01 and designate the markdown version of the specification as authoritative and direct the Chair supported by the Editors to perform any tasks as required by TC Admin to facilitate that issuance. I further move that the TC approve submitting CSAF Version 2.0 Committee Specification Draft 01 for 30 days public review and direct the Chair perform any tasks as required by TC Admin to facilitate that issuance.

My suggestion is to agree during the meeting on the URLs by just copying the URL of the editor draft and generate a zipfile of the three schema files and the markdown file as service for TC Admins. The designation of the normative format is relevant when TC Admin adds the generated HTML and PDF variants to the markdown source for publication and review.

The current URLs for the 4 artifacts we submit to TC Admins would be:

- https://github.com/oasis-tcs/csaf/blob/ca2d9a872b3ce7249c41532961507490724158d6/csaf_2.0/prose/csaf-v2-editor-draft.md

https://github.com/oasis-tcs/csaf/blob/ca2d9a872b3ce7249c41532961507490724158d6/csaf_2.0/json_schema/aggregator_json_schema.json

https://github.com/oasis-tcs/csaf/blob/ca2d9a872b3ce7249c41532961507490724158d6/csaf_2.0/json_schema/csaf_json_schema.json

https://github.com/oasis-tcs/csaf/blob/ca2d9a872b3ce7249c41532961507490724158d6/csaf_2.0/json_schema/provider_json_schema.json

Unfortunately I currently do not have access to a machine to generate a zip archive and upload this here, but any note on the four specific URLs should be sufficiently safe to generate a zip file after the meeting.

Originally posted by @sthagen https://github.com/sthagen in #329 (comment) https://github.com/oasis-tcs/csaf/pull/329#issuecomment-888418320

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/oasis-tcs/csaf/issues/331, or unsubscribe https://github.com/notifications/unsubscribe-auth/ACYUWRPB2SM5VBKZNH7PAJLT2ARB3ANCNFSM5BEULFIQ .

-- Chet Ensign

Chief Technical Community Steward

OASIS Open

+1 201-341-1393 <+1+201-341-1393> @.*** www.oasis-open.org

santosomar commented 3 years ago

Thank you! I agree. We will discuss in less than an hour during today's call. Thanks again!

santosomar commented 3 years ago

The TC meeting didn't reach quorum "Voting Members: 9 of 18 (50%) (used for quorum calculation)" @sthagen will submit motion via email and I will second it. This will give the TC a week to provide any additional discussions or questions. I will close this issue, once the motion is in email.

sthagen commented 3 years ago

@santosomar @tschmidtb51 @mprpic @tolim I sent the motion per E-mail https://www.oasis-open.org/apps/org/workgroup/csaf/email/archives/202107/msg00006.html (publicly accessible link: https://lists.oasis-open.org/archives/csaf/202107/msg00006.html)

@chet-ensign In case this is not sufficient please kindly advise. Thanks for the great support, much appreciated.

chet-ensign commented 3 years ago

This works just fine. Thanks Stefan.

On Wed, Jul 28, 2021 at 1:25 PM Stefan Hagen @.***> wrote:

@santosomar https://github.com/santosomar @tschmidtb51 https://github.com/tschmidtb51 @mprpic https://github.com/mprpic @tolim https://github.com/tolim I sent the motion per E-mail https://www.oasis-open.org/apps/org/workgroup/csaf/email/archives/202107/msg00006.html

@chet-ensign https://github.com/chet-ensign In case this is not sufficient please kindly advise. Thanks for the great support, much appreciated.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/oasis-tcs/csaf/issues/331#issuecomment-888486364, or unsubscribe https://github.com/notifications/unsubscribe-auth/ACYUWRLQCU2L3DH7WEE5ELLT2A4Q3ANCNFSM5BEULFIQ .

-- Chet Ensign

Chief Technical Community Steward

OASIS Open

+1 201-341-1393 <+1+201-341-1393> @.*** www.oasis-open.org

santosomar commented 3 years ago

I second this motion. https://www.oasis-open.org/apps/org/workgroup/csaf/email/archives/202107/msg00007.html (publicly accessible link: https://lists.oasis-open.org/archives/csaf/202107/msg00007.html)

tolim commented 3 years ago

I also second this motion. https://www.oasis-open.org/apps/org/workgroup/csaf/email/archives/202107/msg00009.html (publicly accessible link: https://lists.oasis-open.org/archives/csaf/202107/msg00009.html)

sthagen commented 3 years ago

@chet-ensign I provided the zip archive as input to the TC admin publication process per csd-01-20210805-rc1 - is there a need to store a copy in kavi or does the release on GitHub suffice to start the processing?

Update: I added #332 to track the processing

OASIS-OP-Admin commented 3 years ago

@sthagen - the GH release is fine. We'll be publishing the CSD on the docs.oasis- server so that will be the official version for review purposes.

sthagen commented 3 years ago

@OASIS-OP-Admin long time since I last requested publication and different role (no Secretary here anymore). Question: would it be a good time to now request the publication per admin form and if so, can I do this or are Chair and Secretary the only roles capable of the submission? Or is this in the works already 😕 Thanks. @santosomar, @chet-ensign

OASIS-OP-Admin commented 3 years ago

You can submit the request. No limitations on that. Here is the form to assign us to do it. https://www.oasis-open.org/project-administration-support-requests/form-publish-a-draft-document/

sthagen commented 3 years ago

@OASIS-OP-Admin so I did, all well, but … the exit page after successful submission https://www.oasis-open.org/project-administration-support-requests/form-publish-a-draft-document/ states a note right in the middle paragraph:

Note: If you wish to publish the draft document and submit it for public review, please skip this ticket and fill out Request a first public review or Request a second or subsequent public review instead.

I hope the motion link added to the request makes it clear that we are in for Committee Specification Draft 01 / Public Review Draft 01 …

chet-ensign commented 3 years ago

Yes - main thing is that you only have to enter 1 ticket. We can take it from there.

/chet

On Tue, Aug 10, 2021 at 10:34 AM Stefan Hagen @.***> wrote:

@OASIS-OP-Admin https://github.com/OASIS-OP-Admin so I did, all well, but … the exit page after successful submission https://www.oasis-open.org/project-administration-support-requests/form-publish-a-draft-document/ states a note right in the middle paragraph:

Note: If you wish to publish the draft document and submit it for public review, please skip this ticket and fill out Request a first public review or Request a second or subsequent public review instead.

I hope the motion link added to the request makes it clear that we are in for Committee Specification Draft 01 / Public Review Draft 01 …

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub https://github.com/oasis-tcs/csaf/issues/331#issuecomment-896082926, or unsubscribe https://github.com/notifications/unsubscribe-auth/ACYUWRPW3ZTAENROR5G3Q3DT4E2H5ANCNFSM5BEULFIQ . Triage notifications on the go with GitHub Mobile for iOS https://apps.apple.com/app/apple-store/id1477376905?ct=notification-email&mt=8&pt=524675 or Android https://play.google.com/store/apps/details?id=com.github.android&utm_campaign=notification-email .

-- Chet Ensign

Chief Technical Community Steward

OASIS Open

+1 201-341-1393 <+1+201-341-1393> @.*** www.oasis-open.org