[OAUTH-WG] Nit: Language in section 1.1

Greg Brail <greg@apigee.com> Tue, 13 September 2011 23:22 UTC

Return-Path: <greg@apigee.com>
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 77B9321F8B58 for <oauth@ietfa.amsl.com>; Tue, 13 Sep 2011 16:22:59 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.117
X-Spam-Level:
X-Spam-Status: No, score=-1.117 tagged_above=-999 required=5 tests=[BAYES_20=-0.74, FM_FORGED_GMAIL=0.622, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_LOW=-1]
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 g7AnVzAvTAH3 for <oauth@ietfa.amsl.com>; Tue, 13 Sep 2011 16:22:59 -0700 (PDT)
Received: from mail-wy0-f172.google.com (mail-wy0-f172.google.com [74.125.82.172]) by ietfa.amsl.com (Postfix) with ESMTP id B945921F8B57 for <oauth@ietf.org>; Tue, 13 Sep 2011 16:22:58 -0700 (PDT)
Received: by wyg24 with SMTP id 24so1095554wyg.31 for <oauth@ietf.org>; Tue, 13 Sep 2011 16:25:05 -0700 (PDT)
Received: by 10.227.10.139 with SMTP id p11mr169065wbp.61.1315956305553; Tue, 13 Sep 2011 16:25:05 -0700 (PDT)
From: Greg Brail <greg@apigee.com>
MIME-Version: 1.0
X-Mailer: Microsoft Office Outlook 12.0
Thread-Index: AcxybF9R2lxnY4gAQ9mG3bxIvG1BJA==
Date: Tue, 13 Sep 2011 16:25:06 -0700
Message-ID: <63404c9b49bccfbff551bb973679b77d@mail.gmail.com>
To: oauth@ietf.org
Content-Type: multipart/alternative; boundary="002215974dfa21e9f904acdaf4be"
X-Mailman-Approved-At: Wed, 14 Sep 2011 04:34:05 -0700
Subject: [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: Tue, 13 Sep 2011 23:51:58 -0000

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