Re: [hybi] RfC: LCWD of WebSocket API; deadline June 14

Julian Reschke <julian.reschke@gmx.de> Thu, 24 May 2012 19:13 UTC

Return-Path: <julian.reschke@gmx.de>
X-Original-To: hybi@ietfa.amsl.com
Delivered-To: hybi@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 4BEC611E80E6 for <hybi@ietfa.amsl.com>; Thu, 24 May 2012 12:13:56 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -102.599
X-Spam-Level:
X-Spam-Status: No, score=-102.599 tagged_above=-999 required=5 tests=[AWL=0.000, BAYES_00=-2.599, USER_IN_WHITELIST=-100]
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 Dx0HcsGw5w4f for <hybi@ietfa.amsl.com>; Thu, 24 May 2012 12:13:55 -0700 (PDT)
Received: from mailout-de.gmx.net (mailout-de.gmx.net [213.165.64.23]) by ietfa.amsl.com (Postfix) with SMTP id 4EDEF11E80E2 for <hybi@ietf.org>; Thu, 24 May 2012 12:13:55 -0700 (PDT)
Received: (qmail invoked by alias); 24 May 2012 19:13:53 -0000
Received: from p5DD9682C.dip.t-dialin.net (EHLO [192.168.178.36]) [93.217.104.44] by mail.gmx.net (mp033) with SMTP; 24 May 2012 21:13:53 +0200
X-Authenticated: #1915285
X-Provags-ID: V01U2FsdGVkX18aYIIhxJsaFEmfM+0hHN4WdGo9t6Xmy9iA/YY8HB Kk51uUngYQb4o+
Message-ID: <4FBE886F.8050502@gmx.de>
Date: Thu, 24 May 2012 21:13:51 +0200
From: Julian Reschke <julian.reschke@gmx.de>
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:12.0) Gecko/20120428 Thunderbird/12.0.1
MIME-Version: 1.0
To: Arthur Barstow <art.barstow@nokia.com>
References: <4FBE6DF2.8050705@nokia.com>
In-Reply-To: <4FBE6DF2.8050705@nokia.com>
Content-Type: text/plain; charset="ISO-8859-1"; format="flowed"
Content-Transfer-Encoding: 7bit
X-Y-GMX-Trusted: 0
Cc: public-webapps <public-webapps@w3.org>, "hybi@ietf.org" <hybi@ietf.org>
Subject: Re: [hybi] RfC: LCWD of WebSocket API; deadline June 14
X-BeenThere: hybi@ietf.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: Server-Initiated HTTP <hybi.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/hybi>, <mailto:hybi-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/hybi>
List-Post: <mailto:hybi@ietf.org>
List-Help: <mailto:hybi-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/hybi>, <mailto:hybi-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 24 May 2012 19:13:56 -0000

On 2012-05-24 19:20, Arthur Barstow wrote:
> This is a Request for Comments re the 24-May-2012 LCWD version of the
> WebSocket API:
>
> http://www.w3.org/TR/2012/WD-websockets-20120524/
>
> The comment deadline is June 14 and all comments should be sent to the
> public-webapps@w3.org list. The Bugzilla component for the API is [Bugz].
> ...

I note that many keywords that reference parts of other specs are not 
hyperlinked, so it's extremely hard for a reader to understand what they 
are supposed to mean (phrasing it politely).

For instance, in Section 7:

"If the url string is not an absolute URL, then fail this algorithm."

"absolute URL" is not defined anywhere in this document.

"Resolve the url string, with the URL character encoding set to UTF-8. 
[RFC3629]"

"Resolve" is not defined anywhere in this document.

etc.

Best regards, Julian