Refactoring OpenID Connect Drafts

After the Berlin OpenID AB/C WG F2F meeting, I have been trying to refactor the Connect suites into more palatable form. I am supposed to create two sets of the refactored version. One for a granular split version and the other for a monolithic version. Some people like Torsten and Me push for a granular version and people like Brian is pushing for a monolithic version. Note: Since it is just a refactoring, no normative change is being made. It is essentially cut and paste of the paragraphs into different orders.

Since monolithic version amounts to concatenating the granular version, I have started working on the partitioned version first.

Here is the layout:

And here is the monolithic concatenated version.

I clearly like the partitioned version. You can just read what you want, and the order of the docs are clear. But, YMMV.

NB: These specs are not going to be touched by this reorganization.

  • OpenID Connect – Part 7: Discovery
  • OpenID Connect – Part 8: Dynamic Registration
  • OpenID Connect – Part 9: Session Management

I will keep updating them for sometime, but in the mean time, your comments are welcome.


Add a Comment

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.