Re: [OAUTH-WG] Nit: Language in section 1.1

Justin Richer <jricher@mitre.org> Wed, 14 September 2011 13:03 UTC

Return-Path: <jricher@mitre.org>
X-Original-To: oauth@ietfa.amsl.com
Delivered-To: oauth@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 0942F21F8CC2 for <oauth@ietfa.amsl.com>; Wed, 14 Sep 2011 06:03:10 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -6.58
X-Spam-Level:
X-Spam-Status: No, score=-6.58 tagged_above=-999 required=5 tests=[AWL=0.019, BAYES_00=-2.599, RCVD_IN_DNSWL_MED=-4]
Received: from mail.ietf.org ([12.22.58.30]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id W5wK5jFKYL8q for <oauth@ietfa.amsl.com>; Wed, 14 Sep 2011 06:03:09 -0700 (PDT)
Received: from smtpksrv1.mitre.org (smtpksrv1.mitre.org [198.49.146.77]) by ietfa.amsl.com (Postfix) with ESMTP id 8A19C21F8C99 for <oauth@ietf.org>; Wed, 14 Sep 2011 06:03:09 -0700 (PDT)
Received: from smtpksrv1.mitre.org (localhost.localdomain [127.0.0.1]) by localhost (Postfix) with SMTP id 4667921B0BED; Wed, 14 Sep 2011 09:05:16 -0400 (EDT)
Received: from IMCCAS02.MITRE.ORG (imccas02.mitre.org [129.83.29.79]) by smtpksrv1.mitre.org (Postfix) with ESMTP id 3ECE621B0A65; Wed, 14 Sep 2011 09:05:16 -0400 (EDT)
Received: from [129.83.50.1] (129.83.31.55) by IMCCAS02.MITRE.ORG (129.83.29.79) with Microsoft SMTP Server id 14.1.270.1; Wed, 14 Sep 2011 09:05:15 -0400
From: Justin Richer <jricher@mitre.org>
To: Greg Brail <greg@apigee.com>
In-Reply-To: <63404c9b49bccfbff551bb973679b77d@mail.gmail.com>
References: <63404c9b49bccfbff551bb973679b77d@mail.gmail.com>
Content-Type: text/plain; charset="UTF-8"
Date: Wed, 14 Sep 2011 09:04:05 -0400
Message-ID: <1316005445.9516.35.camel@ground>
MIME-Version: 1.0
X-Mailer: Evolution 2.32.2
Content-Transfer-Encoding: 8bit
Cc: "oauth@ietf.org" <oauth@ietf.org>
Subject: Re: [OAUTH-WG] Nit: Language in section 1.1
X-BeenThere: oauth@ietf.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: OAUTH WG <oauth.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/oauth>, <mailto:oauth-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/oauth>
List-Post: <mailto:oauth@ietf.org>
List-Help: <mailto:oauth-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/oauth>, <mailto:oauth-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 14 Sep 2011 13:03:10 -0000

+1, this wording is much clearer to me, too

 -- justin

On Tue, 2011-09-13 at 19:25 -0400, Greg Brail wrote:
> This part of section 1.1 is confusing to me and I stumble whenever I
> read it – I see that Brian Eaton suggested looking at it a while back
> but I don’t think it got changed:
> 
>  
> 
> “OAuth includes four roles working together to grant and provide
> 
>    access to protected resources - access restricted resources
> requiring
> 
>    authentication:”
> 
>  
> 
> I would suggest something simpler, such as:
> 
>  
> 
> “OAuth includes four roles that work together to grant and provide
> access to protected resources that require authentication.”
> 
>  
> 
>  
> 
> Gregory Brail   |   Technology   |   Apigee   |   +1-650-937-9302
> 
>  
> 
>