From gail at oidf.org  Tue Sep 26 16:00:08 2023
From: gail at oidf.org (Gail Hodges)
Date: Tue, 26 Sep 2023 16:00:08 +0000
Subject: Versioning proposal
In-Reply-To: <CANtBS9d5+FjcrNgWmZFe3nyXpe1HM7uDQjT+OBSn0hTuqus53w@mail.gmail.com>
References: <CANtBS9d5+FjcrNgWmZFe3nyXpe1HM7uDQjT+OBSn0hTuqus53w@mail.gmail.com>
Message-ID: <CO3PR18MB48775936E2142AE4023E2070A9C3A@CO3PR18MB4877.namprd18.prod.outlook.com>

Atul

Many thanks for sharing! Glad you are at a stage to dive deeper into the mechanics of versioning.

Mike Jones, Mark H

Can you please kindly review and revert to Atuil and the Shared Signals WG?

I am conscious that there has been considerable work by the two of you and others in order to:

  *   Document the current specification processes
  *   Document the unwritten best practices
  *   Create tools to automate those processes, and pilot the automation tools with the DCP WG
  *   Close gaps in the Process Document via discrete changes, which the Process Subgroup of the Board will present to Board prior to vote by the full membership.

Marie- As Secretary, FYI

Gail

From: Atul Tulshibagwale <atul at sgnl.ai>
Date: Monday, September 25, 2023 at 7:55 PM
To: specs at openid.net <specs at openid.net>
Cc: Gail Hodges <gail at oidf.org>, OpenID RISC List <openid-specs-risc at lists.openid.net>, Tim Cappalli <tim.cappalli at microsoft.com>, Backman, Annabelle <richanna at amazon.com>
Subject: Versioning proposal
Hi all,
In the Shared Signals WG, we recently agreed to this versioning proposal.

[Image removed by sender.] Shared Signals Versioning Proposal<https://docs.google.com/document/d/111yCtaF26tYUwOUM_Wg_896X1sE64PhtxQx8Bie7INU/edit?usp=drive_web>

I'm not sure if the OpenID Foundation has anything it uses across all WGs regarding versioning. Could you please review the versioning proposal and let us know if anything needs to be changed?

Thanks,
Atul
Co-chair, Shared Signals WG
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openid.net/pipermail/openid-specs/attachments/20230926/10970a5d/attachment.html>

From michael_b_jones at hotmail.com  Wed Sep 27 01:50:41 2023
From: michael_b_jones at hotmail.com (Michael Jones)
Date: Wed, 27 Sep 2023 01:50:41 +0000
Subject: Versioning proposal
In-Reply-To: <CANtBS9fp+Q=undPyr+Buvt4Tk69fKmhZB5q1CXxUwjZ0r45K+A@mail.gmail.com>
References: <CANtBS9d5+FjcrNgWmZFe3nyXpe1HM7uDQjT+OBSn0hTuqus53w@mail.gmail.com>
 <CO3PR18MB48775936E2142AE4023E2070A9C3A@CO3PR18MB4877.namprd18.prod.outlook.com>
 <CANtBS9fp+Q=undPyr+Buvt4Tk69fKmhZB5q1CXxUwjZ0r45K+A@mail.gmail.com>
Message-ID: <MW4PR02MB742882BA12728FD747E21C1CB7C2A@MW4PR02MB7428.namprd02.prod.outlook.com>

Thanks for bringing this to our attention, Atul.  It seems reasonable.  However, I?m not totally sure how it relates to published draft filenames and the titles and draft numbers within the drafts themselves.  Could we schedule a half-hour call to dive into this?

In particular, I?d like to understand how this relates to the specification version numbers (such as 1.0) and draft numbers (such as 29) as described in the OpenID Foundation specification naming conventions described at https://openid.net/wg/resources/naming-and-contents-of-specifications/.

                                                       Best wishes,
                                                       -- Mike

From: Atul Tulshibagwale <atul at sgnl.ai>
Sent: Tuesday, September 26, 2023 6:00 PM
To: Gail Hodges <gail at oidf.org>
Cc: specs at openid.net; michael_b_jones at hotmail.com; Mark <mark at considrd.consulting>; OpenID RISC List <openid-specs-risc at lists.openid.net>; Tim Cappalli <tim.cappalli at microsoft.com>; Backman, Annabelle <richanna at amazon.com>; majordan at visa.com
Subject: Re: Versioning proposal

Thanks Gail,

Mike and Mark,
You can also review this pull request<https://github.com/openid/sharedsignals/pull/123>, which has the versioning proposal in a Kramdown format. It also uses that versioning proposal in the SSF spec.

Thanks,
Atul



On Tue, Sep 26, 2023 at 9:00?AM Gail Hodges <gail at oidf.org<mailto:gail at oidf.org>> wrote:
Atul

Many thanks for sharing! Glad you are at a stage to dive deeper into the mechanics of versioning.

Mike Jones, Mark H

Can you please kindly review and revert to Atuil and the Shared Signals WG?

I am conscious that there has been considerable work by the two of you and others in order to:

  *   Document the current specification processes
  *   Document the unwritten best practices
  *   Create tools to automate those processes, and pilot the automation tools with the DCP WG
  *   Close gaps in the Process Document via discrete changes, which the Process Subgroup of the Board will present to Board prior to vote by the full membership.

Marie- As Secretary, FYI

Gail

From: Atul Tulshibagwale <atul at sgnl.ai<mailto:atul at sgnl.ai>>
Date: Monday, September 25, 2023 at 7:55 PM
To: specs at openid.net<mailto:specs at openid.net> <specs at openid.net<mailto:specs at openid.net>>
Cc: Gail Hodges <gail at oidf.org<mailto:gail at oidf.org>>, OpenID RISC List <openid-specs-risc at lists.openid.net<mailto:openid-specs-risc at lists.openid.net>>, Tim Cappalli <tim.cappalli at microsoft.com<mailto:tim.cappalli at microsoft.com>>, Backman, Annabelle <richanna at amazon.com<mailto:richanna at amazon.com>>
Subject: Versioning proposal
Hi all,
In the Shared Signals WG, we recently agreed to this versioning proposal.

 Shared Signals Versioning Proposal<https://docs.google.com/document/d/111yCtaF26tYUwOUM_Wg_896X1sE64PhtxQx8Bie7INU/edit?usp=drive_web>
 <https://docs.google.com/document/d/111yCtaF26tYUwOUM_Wg_896X1sE64PhtxQx8Bie7INU/edit?usp=drive_web>
I'm not sure if the OpenID Foundation has anything it uses across all WGs regarding versioning. Could you please review the versioning proposal and let us know if anything needs to be changed?<https://docs.google.com/document/d/111yCtaF26tYUwOUM_Wg_896X1sE64PhtxQx8Bie7INU/edit?usp=drive_web>
 <https://docs.google.com/document/d/111yCtaF26tYUwOUM_Wg_896X1sE64PhtxQx8Bie7INU/edit?usp=drive_web>
Thanks,<https://docs.google.com/document/d/111yCtaF26tYUwOUM_Wg_896X1sE64PhtxQx8Bie7INU/edit?usp=drive_web>
Atul<https://docs.google.com/document/d/111yCtaF26tYUwOUM_Wg_896X1sE64PhtxQx8Bie7INU/edit?usp=drive_web>
Co-chair, Shared Signals WG<https://docs.google.com/document/d/111yCtaF26tYUwOUM_Wg_896X1sE64PhtxQx8Bie7INU/edit?usp=drive_web>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openid.net/pipermail/openid-specs/attachments/20230927/6733daf1/attachment.html>