[Openid-specs-mobile-profile] Minor tweaks to spec sources

Mike Jones Michael.Jones at microsoft.com
Wed Mar 8 01:39:46 UTC 2017

Thanks for clarifying that the sources are in the OpenID bitbucket repository and that the Telstra link is just for rendering purposes.  That satisfies the intent of the IPR policy as far as I'm concerned.  It's in the same category of actions as using xml2rfc on the fly.

I know that there's a bunch of bad links out there now, partly because Bitbucket decommissioned openid.bitbucket.org.  We've largely left it up to the chairs and editors to fix them but if you run across them, sending the chairs a reminder (and cc'ing) me would be helpful.

For what it's worth, the way that the Connect WG uses openid.net/specs is that most work happens at bitbucket.org/openid/connect/.  Only when the working group decides that a set of changes is complete and ready for public use does it manually push a new version to openid.net/specs/.  Those are the stable drafts given individual version numbers and persisted publicly.  It's actually pretty easy and the decision to push a new "current" version out causes the editors to do quality control actions first, like spell checking, reference checking, etc.  We expect people to implement against what's in openid.net/specs.  Only the editors muck with the repository versions.

By the way, I'll say that I appreciate your attention to detail.  It shows in your work.

                                                       Best wishes,
                                                       -- Mike

From: Manger, James [mailto:James.H.Manger at team.telstra.com]
Sent: Tuesday, March 7, 2017 5:17 PM
To: Mike Jones <Michael.Jones at microsoft.com>
Cc: openid-specs-mobile-profile at lists.openid.net
Subject: RE: Minor tweaks to spec sources

Hi Mike,

>  Per your request to point the working group page to https://id.cto.telstra.com/public/openid-connect-account-porting-1_0.html, you may not be aware that the OpenID Foundation IPR procedures require that OpenID specifications be developed on foundation-controlled infrastructure.  Therefore, I need to request that the official copies of spec work currently happening on the Telstra host be moved to one of https://bitbucket.org/openid/mobile, https://github.com/openid, or http://svn.openid.net/, so that future contributions happen on OpenID Foundation infrastructure.  (It's of course fine to have local private copies that you do editing in, but no public references should be made to those copies.)

I would much prefer an openid.net URL pointing to the latest Account Porting .html file in the Bitbucket repo.
The spec work is done on foundation-controlled infrastructure - namely at https://bitbucket.org/openid/mobile/.
The Telstra link is solely because bitbucket seems unable to server an .html as a web page to a browser.

Some other MODRNA WG<http://openid.net/wg/mobile/> specs use xml2rfc.tools.ietf.org links (also not foundation-controlled infrastructure) to dynamically convert .xml from the repo to .html, eg OpenID User Questioning API<https://xml2rfc.tools.ietf.org/cgi-bin/xml2rfc.cgi?Submit=Submit&format=ascii&mode=html&type=ascii&url=https://bitbucket.org/openid/mobile/raw/tip/draft-user-questioning-api.xml>. But that doesn't work properly for the Account Porting spec as it includes a .png image.

The HEART WG<http://openid.net/wg/heart/> page uses links such as http://openid.bitbucket.org/HEART/openid-heart-oauth2.html, but they all seem to be broken.

The FAPI WG<http://openid.net/wg/fapi/> links to markdown (.md) version of the specs directly in the repo. This seems to work well as Bitbucket displays markdown properly.

Some WGs use openid.net/specs/ links. That looks perfect, but I assume this requires manual action (eg by the WG chair) to update every time a change is committed to the repo - an overhead & delay I really want to avoid.

If openid.net can server .html that is automatically pulled from the foundation-controlled repo whenever there is a commit (or, say, every 15 min as an approximation) then I'll use that. Even better if it can pull the repo and runs the repo's build script to create the .html from the .xml and .uml.

I could try to switch from.xml to .md (markdown), which Bitbucket can display nicely. I'm not sure how easy or hard that is, nor whether Bitbucket will display a .png from the repo when showing a .md.

Until then I hope a Telstra link for the latest repo version ("editor's copy") isn't perceived as subverting the IPR procedures.

P.S. There are a lot of broken links to hg.openid.net and openid.bitbucket.org on the WG pages.

James Manger
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openid.net/pipermail/openid-specs-mobile-profile/attachments/20170308/ff3edd1a/attachment.html>

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