Re: [OAUTH-WG] OAuth ABNF

[Eran Hammer <[e-mail]>]

We can do both (provide it as defined and in one section). But someone needs to prepare all the ABNFs first.

EH

From: Chuck Canning [mailto:[e-mail]]
Sent: Monday, April 23, 2012 3:28 PM
To: Eran Hammer; [e-mail] WG ([e-mail])
Subject: RE: OAuth ABNF

As someone trying to implement the spec, I find that I have to jump around the spec to find this information also. Personally, I think grouping the related options in the document might make it more clear instead of grouping it based on a concept and then the next style of flow. It might also help shine light on the holes in the spec or where things are ambiguous or not clearly defined. (ie. clearly defining all the options for a particular URI together instead of having to jump over multiple sections and mentally comparing each option).

From: [e-mail]<mailto:[e-mail]> [mailto:[e-mail]]<mailto:[mailto:[e-mail]]> On Behalf Of Eran Hammer
Sent: Monday, April 23, 2012 2:20 PM
To: [e-mail]<mailto:[e-mail]> WG ([e-mail]<mailto:[e-mail]>)
Subject: [SPAM] [OAUTH-WG] OAuth ABNF
Importance: Low


During the IESG review of draft-ietf-oauth-v2, Sean Turner raised the following DISCUSS item (meaning, the specification is blocked until this is resolved):



> 0) General: I found the lack of ABNF somewhat disconcerting in that

> implementers would have to hunt through the spec to figure out all the

> values of a given field.  For example grant_type has different values based

> on the different kind of access_token requests - four to be more precise -

> but there's no ABNF for the field.  There are many examples of

> this.   It would greatly aid implementers if a) the ABNF for all fields

> were included in the draft and b) all the ABNF was collected in one place.  I

> had individual discusses for each field that had missing ABNF, but it was

> getting out of hand so I'm just going to do this one general discuss on this

> topic.

I don't have the time to prepare such text. Can someone volunteer to submit this text to the WG for review?

EH