[Openid-specs-mobile-profile] Account Porting link on MORNA page

Manger, James James.H.Manger at team.telstra.com
Wed Mar 22 23:39:18 UTC 2017


The issue isn’t Bitbucket access (that is fine, after an initial glitch many months ago), but displaying .html properly.

The latest Editor’s Draft is:
https://bitbucket.org/openid/mobile/raw/tip/openid-connect-account-porting-1_0.html
https://bitbucket.org/openid/mobile/raw/tip/openid-connect-account-porting-1_0.xml
https://bitbucket.org/openid/mobile/raw/tip/openid-connect-account-porting-1_0.eg.uml
https://bitbucket.org/openid/mobile/raw/tip/openid-connect-account-porting-1_0.eg.png

.xml is the main spec.
.uml describes the example flow in appendix A.
.png is generated from .uml (using plantuml).
.html is generated from .xml plus 1 line of script to fix the <img> link to .png.

Bitbucket can show the .html source, but doesn’t display the .html as a web page. However, the latter is what almost everyone needs.
https://id.cto.telstra.com/public/openid-connect-account-porting-1_0.html is the spec served from my clone of the Bitbucket repo (and https://id.cto.telstra.com/2016/openid/draft-account-porting.html just redirects to that). These links are not perfect — they aren’t from openid.net; they can show changes I haven’t pushed to Bitbucket yet (or even committed to my clone yet) — but they are up-to-date without having to ask Bjorn or John to edit the working group page each time there is an edit.


Short-term suggestion for http://openid.net/wg/mobile/:

·         Add a link to the repo: https://bitbucket.org/openid/mobile (or https://bitbucket.org/openid/mobile/src)

·         For Account Porting (and the other spec) link to the latest “official” published version (http://openid.net/specs/openid-connect-account-porting-1_0.html) and to the latest Editor’s Draft (.html from the repo displayed as a web page, eg https://id.cto.telstra.com/public/openid-connect-account-porting-1_0.html). The latest Editor’s Draft should get the most prominence on the working group page. The former is the best to list on http://openid.net/developers/specs/.

·         For extra points, link to a diff between the 2 (latest “official” to latest Editor’s Draft).
https://tools.ietf.org/rfcdiff?url1=https://id.cto.telstra.com/public/openid-connect-account-porting-1_0-07.txt&url2=https://id.cto.telstra.com/public/openid-connect-account-porting-1_0.txt
The best I can manage for the diff at the moment is to point tools.ietf.org/rfcdiff at .txt versions of the latest “official” and latest Editor’s Draft. The .txt isn’t in the repo. It is generated from the .xml (plus 1 line of script to support some Unicode characters).

Long-term suggestion:

·         Remove generated files (.html and .png) from the repo

·         Add a build script to the repo that generates .html, .png, .txt, diffs…

·         Configure some scripts (Continuous Integration) to automatically update openid.net whenever the repo changes

--
James Manger


From: John Bradley [mailto:ve7jtb at ve7jtb.com]
Sent: Thursday, 23 March 2017 3:14 AM
To: Bjorn Hjelm <Bjorn.Hjelm at VerizonWireless.com>
Cc: Axel Nennker <Axel.Nennker at telekom.de>; Manger, James <James.H.Manger at team.telstra.com>; openid-specs-mobile-profile at lists.openid.net
Subject: Re: Account Porting link on MORNA page

I can update the link now.

I think James had some issue accessing the OIDF bitbucket where all the other specs are.

We are starting to use Github for the OpenYolo specs and all the open source projects.

We should keep all the MODRNA spec source together if we can.

John B.
On Mar 22, 2017, at 12:36 PM, Hjelm, Bjorn <Bjorn.Hjelm at VerizonWireless.com<mailto:Bjorn.Hjelm at VerizonWireless.com>> wrote:

Axel,
James had requested this and it’ll be updated shortly.

BR,
Bjorn

From: Axel.Nennker at telekom.de<mailto:Axel.Nennker at telekom.de> [mailto:Axel.Nennker at telekom.de]
Sent: Wednesday, March 22, 2017 2:09 AM
To: Hjelm, Bjorn; ve7jtb at ve7jtb.com<mailto:ve7jtb at ve7jtb.com>; James.H.Manger at team.telstra.com<mailto:James.H.Manger at team.telstra.com>
Cc: openid-specs-mobile-profile at lists.openid.net<mailto:openid-specs-mobile-profile at lists.openid.net>
Subject: [E] Account Porting link on MORNA page

Hi,

On the MODRNA page https://openid.net/wg/mobile/<https://urldefense.proofpoint.com/v2/url?u=https-3A__openid.net_wg_mobile_&d=DwMFAg&c=udBTRvFvXC5Dhqg7UHpJlPps3mZ3LRxpb6__0PomBTQ&r=NMZJHCV8pjvGIH2fTx9z6l7g7-V-a2xW7ISf9uHdz0A&m=nZ49KhC6mfOsh-IGjc5Xm1P3fAXrO2tYmzHR_BnHtAo&s=d0d0t9T1Bk2CsotFaGc3Ucha7peFIq9AuFXxx7EiZHU&e=> there is a link to https://id.cto.telstra.com/2016/openid/draft-account-porting.html<https://urldefense.proofpoint.com/v2/url?u=https-3A__id.cto.telstra.com_2016_openid_draft-2Daccount-2Dporting.html&d=DwMFAg&c=udBTRvFvXC5Dhqg7UHpJlPps3mZ3LRxpb6__0PomBTQ&r=NMZJHCV8pjvGIH2fTx9z6l7g7-V-a2xW7ISf9uHdz0A&m=nZ49KhC6mfOsh-IGjc5Xm1P3fAXrO2tYmzHR_BnHtAo&s=dImOs71_GYf_tp2IhcO06XCY9i9FLIB2Ub26hjv7isQ&e=>

How about to change this to: https://openid.net/specs/openid-connect-account-porting-1_0-07.html<https://urldefense.proofpoint.com/v2/url?u=http-3A__openid.net_specs_openid-2Dconnect-2Daccount-2Dporting-2D1-5F0-2D07.html&d=DwMFAg&c=udBTRvFvXC5Dhqg7UHpJlPps3mZ3LRxpb6__0PomBTQ&r=NMZJHCV8pjvGIH2fTx9z6l7g7-V-a2xW7ISf9uHdz0A&m=nZ49KhC6mfOsh-IGjc5Xm1P3fAXrO2tYmzHR_BnHtAo&s=BxpSNmVIY9hPXgqZPLoUDA-QbDQha1R0qhf6Hjk5Hk8&e=>

I think that developers who look for the latest and greatest and who want to contribute will find ways to  convert the xml to html.
Most developers are happy with the implementers draft version, I think.

Kind regards
Axel

Or move from bitbucket to github?


DEUTSCHE TELEKOM AG
T-Labs (Research & Innovation)
Dipl.-Inform. Axel Nennker
Winterfeldtstr. 21, 10781 Berlin
+491702275312 (Mobile)
E-Mail: axel.nennker at telekom.de<mailto:axel.nennker at telekom.de>

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openid.net/pipermail/openid-specs-mobile-profile/attachments/20170322/9d6ba6f3/attachment-0001.html>


More information about the Openid-specs-mobile-profile mailing list