<div dir="ltr">oops. Sorry. It was meant to be sent to the board list. <div><br></div><div>I will re-post it there so let us continue the discussion there. </div><div><br></div><div>Nat</div></div><div class="gmail_extra">
<br><br><div class="gmail_quote">2014-08-12 11:43 GMT+09:00 Mike Jones <span dir="ltr"><<a href="mailto:Michael.Jones@microsoft.com" target="_blank">Michael.Jones@microsoft.com</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div lang="EN-US" link="blue" vlink="purple">
<div>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d">Here’s my comments on your proposed actions:<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"><u></u> <u></u></span></p>
<p class="MsoNormal" style="margin-left:.25in">1. Declare clearly in <a href="http://openid.net/specs/" target="_blank">
http://openid.net/specs/</a> that HTML files are authoritative and others are not. <u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d">We could do this in a readme.txt file there.<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"><u></u> <u></u></span></p>
<p class="MsoNormal" style="margin-left:.25in">2. Remove all XML files from <a href="http://openid.net/specs/" target="_blank">
http://openid.net/specs/</a>. <u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d">I strongly oppose doing this. The files provide useful documentation on what has changed between versions. They’re a lot easier to diff than the outputs.
Also, we could lose <a href="http://svn.openid.net" target="_blank">svn.openid.net</a> at some point, which is the only other place that these source files are authoritatively recorded for the foundation.<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"><u></u> <u></u></span></p>
<p class="MsoNormal" style="margin-left:.25in">3. Put explanatory note in the XML files that they are not official and ipr="..." and other tags are there just to satisfy the tools. <u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d">Agreed<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"><u></u> <u></u></span></p>
<p class="MsoNormal" style="margin-left:.25in">4. Use ipr="none" instead of ipr="full200902" in the XML file. <u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d">Agreed. And we should say that the “Notices” section contains the pertinent IPR information.<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"><u></u> <u></u></span></p>
<p class="MsoNormal" style="margin-left:.25in">5. Put the link to the OpenID IPR Policy to the text "<span style="font-family:"Verdana","sans-serif";color:black">The OpenID Intellectual Property Rights policy"</span><u></u><u></u></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d">I would not include links to specific IPR documents in the comment because we update these from time to time. If you want to say anything in the comment, you
could just say that current versions of the OpenID IPR Policy and Process documents can be found at <a href="http://openid.net" target="_blank">openid.net</a>. The board has already decided that the text in the Notices section is sufficient in this regard.<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"><u></u> <u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"> Thanks,<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"> -- Mike<u></u><u></u></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:"Calibri","sans-serif";color:#1f497d"><u></u> <u></u></span></p>
<p class="MsoNormal"><b><span style="font-size:10.0pt;font-family:"Tahoma","sans-serif"">From:</span></b><span style="font-size:10.0pt;font-family:"Tahoma","sans-serif""> <a href="mailto:openid-specs-ab-bounces@lists.openid.net" target="_blank">openid-specs-ab-bounces@lists.openid.net</a> [mailto:<a href="mailto:openid-specs-ab-bounces@lists.openid.net" target="_blank">openid-specs-ab-bounces@lists.openid.net</a>]
<b>On Behalf Of </b>Nat Sakimura<br>
<b>Sent:</b> Monday, August 11, 2014 7:27 PM<br>
<b>To:</b> <a href="mailto:openid-specs-ab@lists.openid.net" target="_blank">openid-specs-ab@lists.openid.net</a><br>
<b>Subject:</b> [Openid-specs-ab] Making statement that XML sources of the specs are unofficial<u></u><u></u></span></p><div><div class="h5">
<p class="MsoNormal"><u></u> <u></u></p>
<p class="MsoNormal">Dear board members, <u></u><u></u></p>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">I have found out that the XML source code for our specifications are having the following. <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal"><?rfc ipr="full200902"> and <?rfc private="Final"><u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">which indicates that the file follows IETF's IPR rather than OpenID Foundation's, and it is a private note and not a public document. <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">As I found out, it was put there to satisfy the tool that we are using: xml2rfc. <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">In the time of OpenID Authentication 2.0, it was using <?rfc ipr="full3978">. <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">It is fine as long as these files are unofficial tool only, but there is no indication of it as it stands now. <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">Further investigation lead me to find out that these XML files were not recorded in official
<a href="http://openid.net/specs/" target="_blank">http://openid.net/specs/</a> folder before OpenID Connect. <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">In addition, I have found out that there is no link from the Connect specs to the OpenID IPR Policy although there is a verbal mention of it in the Copyright statement. The reference is not there so the readers cannot find what it is. <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">This lead me to think that we probably need to take the following actions: <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<ol start="1" type="1">
<li class="MsoNormal">
Declare clearly in <a href="http://openid.net/specs/" target="_blank">http://openid.net/specs/</a> that HTML files are authoritative and others are not. <u></u><u></u></li><li class="MsoNormal">
Remove all XML files from <a href="http://openid.net/specs/" target="_blank">http://openid.net/specs/</a>. <u></u><u></u></li><li class="MsoNormal">
Put explanatory note in the XML files that they are not official and ipr="..." and other tags are there just to satisfy the tools. <u></u><u></u></li><li class="MsoNormal">
Use ipr="none" instead of ipr="full200902" in the XML file. <u></u><u></u></li><li class="MsoNormal">
Put the link to the OpenID IPR Policy to the text "<span style="font-family:"Verdana","sans-serif";color:black">The OpenID Intellectual Property Rights policy"</span><u></u><u></u></li></ol>
</div>
<div>
<p class="MsoNormal">My proposal for the XML Comment is as follows: <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<div style="border:solid #cccccc 1.0pt;padding:4.0pt 8.0pt 4.0pt 8.0pt;background:whitesmoke">
<pre style="background:whitesmoke;border:none;padding:0in;border-top-left-radius:3px;border-top-right-radius:3px;border-bottom-right-radius:3px;border-bottom-left-radius:3px;word-wrap:normal"><span style="font-size:9.0pt;font-family:Courier;color:#333333"><u></u> <u></u></span></pre>
<pre style="background:whitesmoke;border:none;padding:0in"><i><span style="font-size:9.0pt;font-family:Courier;color:#999988"><!--</span></i><span style="font-size:9.0pt;font-family:Courier;color:#333333"><u></u><u></u></span></pre>
<pre style="background:whitesmoke;border:none;padding:0in"><i><span style="font-size:9.0pt;font-family:Courier;color:#999988">NOTE on this XML File. </span></i><span style="font-size:9.0pt;font-family:Courier;color:#333333"><u></u><u></u></span></pre>
<pre style="background:whitesmoke;border:none;padding:0in"><span style="font-size:9.0pt;font-family:Courier;color:#333333"><u></u> <u></u></span></pre>
<pre style="background:whitesmoke;border:none;padding:0in"><i><span style="font-size:9.0pt;font-family:Courier;color:#999988">This XML file is a tool to produce the authoritative copy of OpenID Foundation spec. </span></i><span style="font-size:9.0pt;font-family:Courier;color:#333333"><u></u><u></u></span></pre>
<pre style="background:whitesmoke;border:none;padding:0in"><i><span style="font-size:9.0pt;font-family:Courier;color:#999988">The authoritative copy is the HTML, and the corresponding XML source is not authoritative. </span></i><span style="font-size:9.0pt;font-family:Courier;color:#333333"><u></u><u></u></span></pre>
<pre style="background:whitesmoke;border:none;padding:0in"><i><span style="font-size:9.0pt;font-family:Courier;color:#999988">The statement that ipr="none" is here only to satisfy the tool. </span></i><span style="font-size:9.0pt;font-family:Courier;color:#333333"><u></u><u></u></span></pre>
<pre style="background:whitesmoke;border:none;padding:0in"><i><span style="font-size:9.0pt;font-family:Courier;color:#999988">The IPR of this document is OpenID IPR Policy found at </span></i><span style="font-size:9.0pt;font-family:Courier;color:#333333"><u></u><u></u></span></pre>
<pre style="background:whitesmoke;border:none;padding:0in"><i><span style="font-size:9.0pt;font-family:Courier;color:#999988"><a href="http://openid.net/ipr/OpenID_IPR_Policy_(Final_Clean_20071221).pdf" target="_blank">http://openid.net/ipr/OpenID_IPR_Policy_(Final_Clean_20071221).pdf</a> </span></i><span style="font-size:9.0pt;font-family:Courier;color:#333333"><u></u><u></u></span></pre>
<pre style="background:whitesmoke;border:none;padding:0in"><i><span style="font-size:9.0pt;font-family:Courier;color:#999988">and governed by OpenID Process found at </span></i><span style="font-size:9.0pt;font-family:Courier;color:#333333"><u></u><u></u></span></pre>
<pre style="background:whitesmoke;border:none;padding:0in"><i><span style="font-size:9.0pt;font-family:Courier;color:#999988"><a href="http://openid.net/wordpress-content/uploads/2010/01/OpenID_Process_Document_December_2009_Final_Approved.pdf" target="_blank">http://openid.net/wordpress-content/uploads/2010/01/OpenID_Process_Document_December_2009_Final_Approved.pdf</a>. </span></i><span style="font-size:9.0pt;font-family:Courier;color:#333333"><u></u><u></u></span></pre>
<pre style="background:whitesmoke;border:none;padding:0in"><i><span style="font-size:9.0pt;font-family:Courier;color:#999988">The directive private="..." is here only to satisfy the tool and desired HTML output. </span></i><span style="font-size:9.0pt;font-family:Courier;color:#333333"><u></u><u></u></span></pre>
<pre style="background:whitesmoke;border:none;padding:0in"><i><span style="font-size:9.0pt;font-family:Courier;color:#999988">This is a public OIDF document and not an individual private memo as private="..." indicates. </span></i><span style="font-size:9.0pt;font-family:Courier;color:#333333"><u></u><u></u></span></pre>
<pre style="background:whitesmoke;border:none;padding:0in"><i><span style="font-size:9.0pt;font-family:Courier;color:#999988">--></span></i><span style="font-size:9.0pt;font-family:Courier;color:#333333"><u></u><u></u></span></pre>
</div>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">This is supposed to be put in at the top of the file right after the DOCTYPE declaration. <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">And my proposal for the /specs/ pages is to put the following after the first paragraph. <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">NOTE: HTML files are the authoritative version. All other formats are provided for the convenience of the readers. <u></u><u></u></p>
</div>
<div>
<p class="MsoNormal"><u></u> <u></u></p>
</div>
<div>
<p class="MsoNormal">Please discuss. After some discussion time, I will craft a motion for the email vote. <u></u><u></u></p>
</div>
<p class="MsoNormal">-- <br>
Nat Sakimura (=nat)<u></u><u></u></p>
<p class="MsoNormal">Chairman, OpenID Foundation<br>
<a href="http://nat.sakimura.org/" target="_blank">http://nat.sakimura.org/</a><br>
@_nat_en<u></u><u></u></p>
</div></div></div>
</div>
</blockquote></div><br><br clear="all"><div><br></div>-- <br>Nat Sakimura (=nat)<div>Chairman, OpenID Foundation<br><a href="http://nat.sakimura.org/" target="_blank">http://nat.sakimura.org/</a><br>@_nat_en</div>
</div>