[rtcweb] draft-ietf-rtcweb-overview-09 Review

Colton Shields <cshields@getjive.com> Mon, 16 June 2014 16:00 UTC

Return-Path: <cshields@getjive.com>
X-Original-To: rtcweb@ietfa.amsl.com
Delivered-To: rtcweb@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 54C611A010C for <rtcweb@ietfa.amsl.com>; Mon, 16 Jun 2014 09:00:19 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.001
X-Spam-Level:
X-Spam-Status: No, score=-2.001 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, SPF_PASS=-0.001] autolearn=ham
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id DJGCwwobyrYL for <rtcweb@ietfa.amsl.com>; Mon, 16 Jun 2014 09:00:17 -0700 (PDT)
Received: from mail-ie0-x232.google.com (mail-ie0-x232.google.com [IPv6:2607:f8b0:4001:c03::232]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id F3B111A00FD for <rtcweb@ietf.org>; Mon, 16 Jun 2014 09:00:14 -0700 (PDT)
Received: by mail-ie0-f178.google.com with SMTP id rd18so5028608iec.23 for <rtcweb@ietf.org>; Mon, 16 Jun 2014 09:00:14 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=getjive.com; s=mail; h=message-id:date:from:user-agent:mime-version:to:subject:references :in-reply-to:content-type:content-transfer-encoding; bh=KhaQBhCL1aYnwakhSHPO/CXP4MZe+5lYJQcQxvUBE9A=; b=KjjzpkaTITliDq/a9jnPZ5rKQ48Ezw7C1NAo2K4dqcvZeAk59QXIv9OHf3c4DjTnsf YFhlkXKKqUMIaH5d++qMM0YNbO11sJ0hYQgx6ZwE+F+rinmWvIV8hnWWifm0sXS4Pb7r kAxmEqFcu3wqe3X7GIknHGuMzZeLLIFHanGOU=
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:message-id:date:from:user-agent:mime-version:to :subject:references:in-reply-to:content-type :content-transfer-encoding; bh=KhaQBhCL1aYnwakhSHPO/CXP4MZe+5lYJQcQxvUBE9A=; b=WET3sZb2fIcNEAWBPkG4LE9lKELXa3yn+4DxvMPsRkNuocBGKn2pi95Ef+Ka1jmoXQ sUBV5HCrimoAwTrtelDJaiwvfDuYIF0oTrW5oIwpxSTy3e7ed0OfYFAbvqd2heCQFmUu H2b/D8Rk/m+Sjr4w9GwI4xatc+qXHSoqVuVSdWM+J5hkr7L4IrVHPMF61wCcePk2JPlB JrzmtvHhKgnRgVTKSP0ZxWDh3DU8LkJ9vtJ+7/NERvCX28uGoccjzG36VUlh9tf9+zS1 BMjsRcHk5t0bl9lnDq+ok4H20gFohi8zr+JIxD+DK/XWRRU0548i6V7AuZorrUJZgGFo eVLQ==
X-Gm-Message-State: ALoCoQk2B3G2wqgLe9WQ0XtWSS1Wt3QIR75vOFk0Gqo07uFv3WwjXVU6g2mXRqigY5XL1rClWoDu
X-Received: by 10.43.160.4 with SMTP id ma4mr3351725icc.83.1402934414167; Mon, 16 Jun 2014 09:00:14 -0700 (PDT)
Received: from jivecommunications.com ([199.87.120.129]) by mx.google.com with ESMTPSA id p12sm21612884igx.18.2014.06.16.09.00.07 for <multiple recipients> (version=TLSv1 cipher=ECDHE-RSA-RC4-SHA bits=128/128); Mon, 16 Jun 2014 09:00:13 -0700 (PDT)
Message-ID: <539F1487.3030808@getjive.com>
Date: Mon, 16 Jun 2014 10:00:07 -0600
From: Colton Shields <cshields@getjive.com>
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.9; rv:24.0) Gecko/20100101 Thunderbird/24.4.0
MIME-Version: 1.0
To: rtcweb@ietf.org
References: <539F118A.8010201@getjive.com>
In-Reply-To: <539F118A.8010201@getjive.com>
X-Enigmail-Version: 1.6
X-Forwarded-Message-Id: <539F118A.8010201@getjive.com>
Content-Type: text/plain; charset="ISO-8859-1"
Content-Transfer-Encoding: 7bit
Archived-At: http://mailarchive.ietf.org/arch/msg/rtcweb/6fSQ0qOtFd-DV9Zi55CKXOgM3YM
Subject: [rtcweb] draft-ietf-rtcweb-overview-09 Review
X-BeenThere: rtcweb@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: Real-Time Communication in WEB-browsers working group list <rtcweb.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/rtcweb>, <mailto:rtcweb-request@ietf.org?subject=unsubscribe>
List-Archive: <http://www.ietf.org/mail-archive/web/rtcweb/>
List-Post: <mailto:rtcweb@ietf.org>
List-Help: <mailto:rtcweb-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/rtcweb>, <mailto:rtcweb-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 16 Jun 2014 16:00:19 -0000

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA512

Here is my review of the Overview: Real Time Protocols for
Browser-based Applications draft-ietf-rtcweb-overview-09. Please take
into consideration my suggestions.

Thanks
- -Colton



Section 3 Paragraph 1

I am a native English speaker and I had to look up the definition of
"envisage". Drafts should be written in the plainest language
possible, to make it easier for everyone to understand.

"The model of real-time support for browser-based applications does
   not envisage that the browser will contain all the functions that
   need to be performed in order to have a function such as a telephone
   or a video conferencing unit;"

I suggest replacing "envisage" with one of the following
	- suppose
	- assume



Section 3 Paragraph 5

"Existing protocols (for example SIP or XMPP) could be used between
servers..."

In case the reader is not familiar with SIP or XMPP, the draft should
link to these protocols. Just like it does with other protocols.
Especially since the next paragraphs provide an example of SIP and
XMPP. If the reader does not understand how SIP or XMPP work they
could get confused. Providing links gives them a resource to
learn how those protocols work.


SIP RFC 3261
http://www.ietf.org/rfc/rfc3261.txt

XMPP RFC 3920
http://www.ietf.org/rfc/rfc3920.txt




Spelling error in the Title

Title should say "Browser-based" rather than "Brower-based"








-----BEGIN PGP SIGNATURE-----
Version: GnuPG/MacGPG2 v2.0.22 (Darwin)
Comment: GPGTools - https://gpgtools.org
Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/

iQEcBAEBCgAGBQJTnxSHAAoJEKWz5R7vDXT70KIIAMD4QhckVf/zFbyN43WJnd/6
AtaahLFVZl7UeNU5KRFnYiedDH2RbVm4L9TgEWAgPiRxzzmsAZDg6CgDe599Q9jS
4oRklaXGMlsF0IoQ7DmvTpUSeiql2dl64rLpTREL1vnXaQN3RbBpdPyuvu5MRUDw
8rS1+eXyf8zL3T71iwsidc2/903r/vNsWE274chIxUGIv/vgW9RX2u1GS1DFvttw
FZRlVc6Xb3BYWrJshwX+uGw8Doiak/yx+IpMdJ5lBzIvRCi13Au4fpdWwsqYME0v
VXoPrWddqGTEJbx+/KkKsWi2hhq7NwQC5usWUT+NQwhJhBQWNaZJDECmotB821o=
=u0qm
-----END PGP SIGNATURE-----