Re: [Gen-art] Last Call Review of draft-ietf-appsawg-text-markdown-use-cases-02
Jari Arkko <jari.arkko@piuha.net> Wed, 08 July 2015 22:26 UTC
Return-Path: <jari.arkko@piuha.net>
X-Original-To: gen-art@ietfa.amsl.com
Delivered-To: gen-art@ietfa.amsl.com
Received: from localhost (ietfa.amsl.com [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 4E24F1A88F4; Wed, 8 Jul 2015 15:26:49 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.91
X-Spam-Level:
X-Spam-Status: No, score=-1.91 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, T_RP_MATCHES_RCVD=-0.01] 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 vPUorwruiBgz; Wed, 8 Jul 2015 15:26:47 -0700 (PDT)
Received: from p130.piuha.net (p130.piuha.net [193.234.218.130]) by ietfa.amsl.com (Postfix) with ESMTP id 818BC1A88F1; Wed, 8 Jul 2015 15:26:47 -0700 (PDT)
Received: from localhost (localhost [127.0.0.1]) by p130.piuha.net (Postfix) with ESMTP id D61352D016; Thu, 9 Jul 2015 01:26:46 +0300 (EEST) (envelope-from jari.arkko@piuha.net)
X-Virus-Scanned: amavisd-new at piuha.net
Received: from p130.piuha.net ([127.0.0.1]) by localhost (p130.piuha.net [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id Q_BNH4ZkSITm; Thu, 9 Jul 2015 01:26:46 +0300 (EEST)
Received: from [127.0.0.1] (p130.piuha.net [IPv6:2a00:1d50:2::130]) by p130.piuha.net (Postfix) with ESMTP id ED54E2D00D; Thu, 9 Jul 2015 01:26:45 +0300 (EEST) (envelope-from jari.arkko@piuha.net)
Mime-Version: 1.0 (Mac OS X Mail 7.3 \(1878.6\))
Content-Type: multipart/signed; boundary="Apple-Mail=_7BDA1E95-37D7-456C-A31D-13CED984BB12"; protocol="application/pgp-signature"; micalg="pgp-sha512"
X-Pgp-Agent: GPGMail 2.5
From: Jari Arkko <jari.arkko@piuha.net>
In-Reply-To: <55982CC2.2060201@gmail.com>
Date: Thu, 09 Jul 2015 00:26:44 +0200
Message-Id: <ECFA296B-531A-4AE3-96EB-ADDB475831D3@piuha.net>
References: <55982CC2.2060201@gmail.com>
To: Tom Taylor <tom.taylor.stds@gmail.com>
X-Mailer: Apple Mail (2.1878.6)
Archived-At: <http://mailarchive.ietf.org/arch/msg/gen-art/T9chpBRlzugPB-lYAk6OR80FsKY>
Cc: Gen Art <gen-art@ietf.org>, Barry Leiba <barryleiba@computer.org>, Murray Kucherawy <superuser@gmail.com>, The IESG <iesg@ietf.org>, Sean Leonard <dev+ietf@seantek.com>
Subject: Re: [Gen-art] Last Call Review of draft-ietf-appsawg-text-markdown-use-cases-02
X-BeenThere: gen-art@ietf.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: "GEN-ART: General Area Review Team" <gen-art.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/gen-art>, <mailto:gen-art-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/gen-art/>
List-Post: <mailto:gen-art@ietf.org>
List-Help: <mailto:gen-art-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/gen-art>, <mailto:gen-art-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 08 Jul 2015 22:26:49 -0000
Thanks for the review and for spotting these, Tom. I agree… Authors? Jari On 04 Jul 2015, at 20:58, Tom Taylor <tom.taylor.stds@gmail.com> wrote: > I am the assigned Gen-ART reviewer for this draft. For background on > Gen-ART, please see the FAQ at > > <http://wiki.tools.ietf.org/area/gen/trac/wiki/GenArtfaq>. > > Please resolve these comments along with any other Last Call comments > you may receive. > > Tom Taylor > > Document: draft-ietf-appsawg-text-markdown-use-cases-02 > Reviewer: Tom Taylor > Review Date: 2015/07/04 > IETF LC End Date: 2015/07/03 > IESG Telechat date: 2015/07/09 > > Summary: Well-written. Ready with nits. > > Major issues: > > Minor issues: > > Nits/editorial comments: > > IDNits reports five instances of control characters in the document. Good luck finding them! > > IDNits reports a number of missing and unused references. > > Sec. 1.1, second para, second-last line: > s/bit are corrupted/bit is corrupted/ > > Sec. 1.3: There seem to be a few missing references, where [CITE] is used as a stand-in. Also see [NB: CITE?] later in that section. > > Sec. 2.7.2: RFC 2119 SHOULD is used, but the usual invocation of RFC 2119 language at the start of the document is missing. The next section (re GIT) uses lower-case "should", and that is probably your best way forward. Actually, IDNits (now that I check) reports a number of other instances of RFC 2119 capitalization, so you'll have to decide what is appropriate. > > Sec. 4.1: s/# MutliMarkdown Example #/# MultiMarkdown Example #/ > > Sec. 4.2 (beginning has this: > ~~Oops this is some mistaken text.~~ > Is that example markdown or a comment on something that has to be fixed? >