[Gen-art] Review of draft-ietf-oauth-jwsreq-09

Joel Halpern <jmh@joelhalpern.com> Tue, 24 January 2017 18:13 UTC

MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
From: Joel Halpern <jmh@joelhalpern.com>
To: gen-art@ietf.org
Auto-Submitted: auto-generated
Precedence: bulk
Message-ID: <148528159990.12590.4203267942543391577.idtracker@ietfa.amsl.com>
Date: Tue, 24 Jan 2017 10:13:19 -0800
Archived-At: <https://mailarchive.ietf.org/arch/msg/gen-art/ky9kufSsw_fY95MGgksWXApCuz0>
Cc: ietf@ietf.org, draft-ietf-oauth-jwsreq.all@ietf.org, oauth@ietf.org
Subject: [Gen-art] Review of draft-ietf-oauth-jwsreq-09

Reviewer: Joel Halpern
Review result: Not Ready

I am the assigned Gen-ART reviewer for this draft. The General Area
Review Team (Gen-ART) reviews all IETF documents being processed
by the IESG for the IETF Chair. Please wait for direction from your
document shepherd or AD before posting a new version of the draft.

For more information, please see the FAQ at

<https://trac.ietf.org/trac/gen/wiki/GenArtfaq>.

Document: draft-ietf-oauth-jwsreq-??
Reviewer: Joel Halpern
Review Date: 2017-01-24
IETF LC End Date: None
IESG Telechat date: 2017-02-02

Summary: This document is not ready for publication as a standards
track RFC.

[Reviewers note:  It is quite possible that the problem listed below
is my error.  In that case, this should be considered as ready with
minor issues.]

Major issues:
    I can not find any record of an IETF last call for this document. 
I looked in the document history and the IETF discussion list.  If I
missed it, I apologize for being oblivious.

Minor issues:
    Why is the example if section 4 (and others later on) described as
"non-normative"?  Is it incomplete?  incorrect?  An example is, by
definition, not a full specification.  The language seems designed to
reduce the value of the example.  I would recommend removing all the
"non-normative" notes from the examples.  They are clearly stated to
be examples. 

Nits/editorial comments:

[Gen-art] Review of draft-ietf-oauth-jwsreq-09 Joel Halpern