Re: [jose] #68: Section 3 - JSON Web Key (JWK) Format

"jose issue tracker" <trac+jose@trac.tools.ietf.org> Tue, 05 November 2013 02:01 UTC

MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit
From: jose issue tracker <trac+jose@trac.tools.ietf.org>
Precedence: bulk
Auto-Submitted: auto-generated
To: draft-ietf-jose-json-web-key@tools.ietf.org, ietf@augustcellars.com
Date: Tue, 05 Nov 2013 02:00:56 -0000
Message-ID: <076.0e26447c457582664570e3d7f37e9981@trac.tools.ietf.org>
References: <061.1644e694b34ebc855764cf6a1a5e2259@trac.tools.ietf.org>
In-Reply-To: <061.1644e694b34ebc855764cf6a1a5e2259@trac.tools.ietf.org>
Resent-To: mbj@microsoft.com
Resent-Message-Id: <20131105020100.AFF1421E8172@ietfa.amsl.com>
Resent-Date: Mon, 04 Nov 2013 18:01:00 -0800
Resent-From: trac+jose@trac.tools.ietf.org
Cc: jose@ietf.org
Subject: Re: [jose] #68: Section 3 - JSON Web Key (JWK) Format

#68: Section 3 - JSON Web Key (JWK) Format

Description changed by ietf@augustcellars.com:

Old description:

> A. The first two sentences are not readable - and may be somewhat
> contradictory.  Suggested re-write as
>
>    ""A JSON Web Key (JWK) is a JSON object.
> The members of the object represent different properties of the key.
> These properties include the value of the key, the usage of the key and
> so forth.
> This document defines a set of parameters that are not algorithm
> specific, and thus common to many keys.""
>
> B. member names within is ambiguous - does this mean within each
> lexicographical scope or completely?
>
> C. In the sentence  Additional members MAY - this may is not a protocol
> requirement.
>
> D. In the sentence - If not understood - please clarify what "they" is
> referring to
>
> E. In paragraph 3 - sentence 2/3 - First you say they may be reused -
> then you tell me they must be collision resistant - please clarify this
> text
>
> F. In paragraph 3 - This should be a reference to the registry not point
> to the section 7.1

New description:

 A. The first two sentences are not readable - and may be somewhat
 contradictory.  Suggested re-write as

    ""A JSON Web Key (JWK) is a JSON object.
 The members of the object represent different properties of the key.
 These properties include the value of the key, the usage of the key and so
 forth.
 This document defines a set of parameters that are not algorithm specific,
 and thus common to many keys.""

 B. member names within is ambiguous - does this mean within each
 lexicographical scope or completely?

 * WON'T FIX - since we don't have nesting at this time, the language is
 not currently ambiguous - it can get fixed when it becomes ambiguous
 again.

 C. In the sentence  Additional members MAY - this may is not a protocol
 requirement.

 D. In the sentence - If not understood - please clarify what "they" is
 referring to

 * WON'T FIX - Punt to the RFC Editor

 E. In paragraph 3 - sentence 2/3 - First you say they may be reused - then
 you tell me they must be collision resistant - please clarify this text

 F. In paragraph 3 - This should be a reference to the registry not point
 to the section 7.1

 * WON'T FIX - My personal peeve

--

-- 
-------------------------+-------------------------------------------------
 Reporter:               |       Owner:  draft-ietf-jose-json-web-
  ietf@augustcellars.com |  key@tools.ietf.org
     Type:  defect       |      Status:  new
 Priority:  Editorial    |   Milestone:
Component:  json-web-    |     Version:
  key                    |  Resolution:
 Severity:  -            |
 Keywords:               |
-------------------------+-------------------------------------------------

Ticket URL: <http://trac.tools.ietf.org/wg/jose/trac/ticket/68#comment:1>
jose <http://tools.ietf.org/jose/>

[jose] #68: Section 3 - JSON Web Key (JWK) Format jose issue tracker
Re: [jose] #68: Section 3 - JSON Web Key (JWK) Fo… jose issue tracker
Re: [jose] #68: Section 3 - JSON Web Key (JWK) Fo… jose issue tracker