<div dir="ltr">Hi Mike and Mark,<div>Thanks for your time today. Here are my notes from the call:</div><div><ol><li>Mike proposed that we do not actually version the protocol, because of two reasons:</li><ol><li>Versions may not be linear. People may add different features and may support different features in the future, so a linear version scale may not make sense. For instance, the OAuth spec is not versioned, but it has many additional features such as PKCE, DPoP, CIBA etc. Participants can individually support these features.</li><li>We already have draft numbering, and protocol version numbers may be hard to distinguish from that.</li></ol><li>Mike proposed that we add specific feature flags in the Transmitter Configuration Metadata. We currently have two things that require versioning:</li><ol><li>Sub_id at top level</li><li>API style (previous API has differences with the current API)</li></ol><li>Mark pointed out some parallels (and pitfalls) with other specs such as Identity Assurance, where they are using this approach.</li></ol><div>This will satisfy our needs and will be a more robust way of supporting multiple new things we may decide to add in the spec later.</div></div><div><br></div><div><b>Action Items</b></div><div><ol><li>Atul to discuss this in the WG meeting tomorrow.</li><li>Atul to update PR based on outcome of WG meeting, but hopefully along the above lines. Mike and Mark to review that PR</li><li>The current versioning proposal PR will be dropped.</li></ol><div>Please respond if I haven't captured anything correctly or you wish to add anything here.</div><div><br></div><div>Atul</div></div><div><br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Mon, Oct 2, 2023 at 11:48 AM Atul Tulshibagwale <<a href="mailto:atul@sgnl.ai">atul@sgnl.ai</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr">Hi Mike and Mark,<div>I've updated the versioning proposal to establish how protocol version numbers discussed in the document will correlate to the spec version numbers defined in the naming document you shared. Please review them here:</div><div><a href="https://docs.google.com/document/d/111yCtaF26tYUwOUM_Wg_896X1sE64PhtxQx8Bie7INU/edit?usp=sharing" target="_blank">https://docs.google.com/document/d/111yCtaF26tYUwOUM_Wg_896X1sE64PhtxQx8Bie7INU/edit?usp=sharing</a><br></div><div><br></div><div>Atul<br></div></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Tue, Sep 26, 2023 at 6:50 PM Michael Jones <<a href="mailto:michael_b_jones@hotmail.com" target="_blank">michael_b_jones@hotmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div>
<div lang="EN-US">
<div>
<p class="MsoNormal">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?<u></u><u></u></p>
<p class="MsoNormal"><u></u> <u></u></p>
<p class="MsoNormal">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
<a href="https://openid.net/wg/resources/naming-and-contents-of-specifications/" target="_blank">
https://openid.net/wg/resources/naming-and-contents-of-specifications/</a>.<u></u><u></u></p>
<p class="MsoNormal"><u></u> <u></u></p>
<p class="MsoNormal"> Best wishes,<u></u><u></u></p>
<p class="MsoNormal"> -- Mike<u></u><u></u></p>
<p class="MsoNormal"><u></u> <u></u></p>
<div style="border-right:none;border-bottom:none;border-left:none;border-top:1pt solid rgb(225,225,225);padding:3pt 0in 0in">
<p class="MsoNormal"><b>From:</b> Atul Tulshibagwale <<a href="mailto:atul@sgnl.ai" target="_blank">atul@sgnl.ai</a>> <br>
<b>Sent:</b> Tuesday, September 26, 2023 6:00 PM<br>
<b>To:</b> Gail Hodges <<a href="mailto:gail@oidf.org" target="_blank">gail@oidf.org</a>><br>
<b>Cc:</b> <a href="mailto:specs@openid.net" target="_blank">specs@openid.net</a>; <a href="mailto:michael_b_jones@hotmail.com" target="_blank">michael_b_jones@hotmail.com</a>; Mark <mark@considrd.consulting>; OpenID RISC List <<a href="mailto:openid-specs-risc@lists.openid.net" target="_blank">openid-specs-risc@lists.openid.net</a>>; Tim Cappalli <<a href="mailto:tim.cappalli@microsoft.com" target="_blank">tim.cappalli@microsoft.com</a>>; Backman, Annabelle <<a href="mailto:richanna@amazon.com" target="_blank">richanna@amazon.com</a>>; <a href="mailto:majordan@visa.com" target="_blank">majordan@visa.com</a><br>
<b>Subject:</b> Re: Versioning proposal<u></u><u></u></p>
</div>
<p class="MsoNormal"><u></u> <u></u></p>
<div>
<p class="MsoNormal">Thanks Gail,<u></u><u></u></p>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">Mike and Mark,<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal">You can also review this <a href="https://github.com/openid/sharedsignals/pull/123" target="_blank">
pull request</a>, which has the versioning proposal in a Kramdown format. It also uses that versioning proposal in the SSF spec.<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">Thanks,<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal">Atul<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
</div>
<p class="MsoNormal"><u></u> <u></u></p>
<div>
<div>
<p class="MsoNormal">On Tue, Sep 26, 2023 at 9:00 AM Gail Hodges <<a href="mailto:gail@oidf.org" target="_blank">gail@oidf.org</a>> wrote:<u></u><u></u></p>
</div>
<blockquote style="border-top:none;border-right:none;border-bottom:none;border-left:1pt solid rgb(204,204,204);padding:0in 0in 0in 6pt;margin-left:4.8pt;margin-right:0in">
<div>
<div>
<div>
<p class="MsoNormal">Atul
<u></u><u></u></p>
<p class="MsoNormal"> <u></u><u></u></p>
<p class="MsoNormal">Many thanks for sharing! Glad you are at a stage to dive deeper into the mechanics of versioning.<u></u><u></u></p>
<p class="MsoNormal"> <u></u><u></u></p>
<p class="MsoNormal"><b>Mike Jones, Mark H</b><u></u><u></u></p>
<p class="MsoNormal"> <u></u><u></u></p>
<p class="MsoNormal">Can you please kindly review and revert to Atuil and the Shared Signals WG?
<u></u><u></u></p>
<p class="MsoNormal"> <u></u><u></u></p>
<p class="MsoNormal">I am conscious that there has been considerable work by the two of you and others in order to:
<u></u><u></u></p>
<ul type="disc">
<li>
Document the current specification processes<u></u><u></u></li><li>
Document the unwritten best practices<u></u><u></u></li><li>
Create tools to automate those processes, and pilot the automation tools with the DCP WG
<u></u><u></u></li><li>
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.
<u></u><u></u></li></ul>
<p class="MsoNormal"> <u></u><u></u></p>
<p class="MsoNormal">Marie- As Secretary, FYI<u></u><u></u></p>
<p class="MsoNormal"> <u></u><u></u></p>
<p class="MsoNormal">Gail
<u></u><u></u></p>
<p class="MsoNormal"> <u></u><u></u></p>
<div style="border-right:none;border-bottom:none;border-left:none;border-top:1pt solid rgb(181,196,223);padding:3pt 0in 0in">
<p class="MsoNormal" style="margin-bottom:12pt"><b><span style="font-size:12pt;color:black">From:
</span></b><span style="font-size:12pt;color:black">Atul Tulshibagwale <<a href="mailto:atul@sgnl.ai" target="_blank">atul@sgnl.ai</a>><br>
<b>Date: </b>Monday, September 25, 2023 at 7:55 PM<br>
<b>To: </b><a href="mailto:specs@openid.net" target="_blank">specs@openid.net</a> <<a href="mailto:specs@openid.net" target="_blank">specs@openid.net</a>><br>
<b>Cc: </b>Gail Hodges <<a href="mailto:gail@oidf.org" target="_blank">gail@oidf.org</a>>, OpenID RISC List <<a href="mailto:openid-specs-risc@lists.openid.net" target="_blank">openid-specs-risc@lists.openid.net</a>>, Tim Cappalli <<a href="mailto:tim.cappalli@microsoft.com" target="_blank">tim.cappalli@microsoft.com</a>>,
Backman, Annabelle <<a href="mailto:richanna@amazon.com" target="_blank">richanna@amazon.com</a>><br>
<b>Subject: </b>Versioning proposal</span><u></u><u></u></p>
</div>
<div>
<p class="MsoNormal">Hi all,<u></u><u></u></p>
<div>
<p class="MsoNormal">In the Shared Signals WG, we recently agreed to this versioning proposal.<u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"> <u></u><u></u></p>
<div style="border:1pt solid rgb(221,221,221);padding:4pt;max-height:18px">
<p class="MsoNormal" style="background:whitesmoke">
<b><span style="font-family:Arial,sans-serif;color:rgb(34,34,34)"><a href="https://docs.google.com/document/d/111yCtaF26tYUwOUM_Wg_896X1sE64PhtxQx8Bie7INU/edit?usp=drive_web" target="_blank"><span style="border:1pt none windowtext;padding:0in;text-decoration:none"> </span><span style="color:rgb(17,85,204);border:1pt none windowtext;padding:0in;text-decoration:none">Shared
Signals Versioning Proposal</span><span style="font-family:Calibri,sans-serif;color:windowtext;font-weight:normal;text-decoration:none"><u></u><u></u></span></a></span></b></p>
</div>
<p class="MsoNormal"><a href="https://docs.google.com/document/d/111yCtaF26tYUwOUM_Wg_896X1sE64PhtxQx8Bie7INU/edit?usp=drive_web" target="_blank"><span style="color:windowtext;text-decoration:none"> <u></u><u></u></span></a></p>
</div>
<div>
<p class="MsoNormal"><a href="https://docs.google.com/document/d/111yCtaF26tYUwOUM_Wg_896X1sE64PhtxQx8Bie7INU/edit?usp=drive_web" target="_blank"><span style="color:windowtext;text-decoration:none">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?<u></u><u></u></span></a></p>
</div>
<div>
<p class="MsoNormal"><a href="https://docs.google.com/document/d/111yCtaF26tYUwOUM_Wg_896X1sE64PhtxQx8Bie7INU/edit?usp=drive_web" target="_blank"><span style="color:windowtext;text-decoration:none"> <u></u><u></u></span></a></p>
</div>
<div>
<p class="MsoNormal"><a href="https://docs.google.com/document/d/111yCtaF26tYUwOUM_Wg_896X1sE64PhtxQx8Bie7INU/edit?usp=drive_web" target="_blank"><span style="color:windowtext;text-decoration:none">Thanks,<u></u><u></u></span></a></p>
</div>
<div>
<p class="MsoNormal"><a href="https://docs.google.com/document/d/111yCtaF26tYUwOUM_Wg_896X1sE64PhtxQx8Bie7INU/edit?usp=drive_web" target="_blank"><span style="color:windowtext;text-decoration:none">Atul<u></u><u></u></span></a></p>
</div>
<div>
<p class="MsoNormal"><a href="https://docs.google.com/document/d/111yCtaF26tYUwOUM_Wg_896X1sE64PhtxQx8Bie7INU/edit?usp=drive_web" target="_blank"><span style="color:windowtext;text-decoration:none">Co-chair,
Shared Signals WG<u></u><u></u></span></a></p>
</div>
</div>
</div>
</div>
</div>
</blockquote>
</div>
</div>
</div>
</div></blockquote></div>
</blockquote></div>