[Gen-art] Last Call Review of draft-ietf-appsawg-text-markdown-use-cases-02
Tom Taylor <tom.taylor.stds@gmail.com> Sat, 04 July 2015 18:58 UTC
Return-Path: <tom.taylor.stds@gmail.com>
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 6CFED1A887D; Sat, 4 Jul 2015 11:58:14 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2
X-Spam-Level:
X-Spam-Status: No, score=-2 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, FREEMAIL_FROM=0.001, 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 BrvzI8uYC83N; Sat, 4 Jul 2015 11:58:13 -0700 (PDT)
Received: from mail-ig0-x22a.google.com (mail-ig0-x22a.google.com [IPv6:2607:f8b0:4001:c05::22a]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id EA09A1A6FF6; Sat, 4 Jul 2015 11:58:12 -0700 (PDT)
Received: by igrv9 with SMTP id v9so132997599igr.1; Sat, 04 Jul 2015 11:58:12 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=from:subject:to:message-id:date:user-agent:mime-version :content-type:content-transfer-encoding; bh=0ftCHG8QEUVBMnC93ccwzBW/xeW983LVtPg5taW+sZ8=; b=XHaSQNcsyGkJxjaqPz4N3A/6AdxDoBF8sDWhYwvlLAPhpXLZPej0Wu2Ux5el/tV8oc vTnRNqh3PVYO6zsRMgN7pBT+teSD+uxM7dkGZ+ShGlhQ75xFE5qCBZTvK0RjpNm/9joF WYZNz8x/ep+qVnHlr+0MWm5y4a2B/hDLSK09NjurWICRmc7uFBl18zlU8VsX0cecHi/d p0MkwmodWtW/iWItK1R1kRCf8Xq7dEoqgAOKP/opG0Ej84rLmivs834NIQRWSHlxYhGT 30NQaRzRgME98tCe/w+TGVuT6oaWXMyAiFBA7PVzFYTnPGvsz1tub2ME/JQVdrtMsgHW baxw==
X-Received: by 10.50.79.129 with SMTP id j1mr30450329igx.32.1436036292413; Sat, 04 Jul 2015 11:58:12 -0700 (PDT)
Received: from [192.168.1.135] (dsl-173-206-6-50.tor.primus.ca. [173.206.6.50]) by smtp.gmail.com with ESMTPSA id vk8sm6122253igb.4.2015.07.04.11.58.11 (version=TLSv1.2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Sat, 04 Jul 2015 11:58:11 -0700 (PDT)
From: Tom Taylor <tom.taylor.stds@gmail.com>
To: Sean Leonard <dev+ietf@seantek.com>, Murray Kucherawy <superuser@gmail.com>, Barry Leiba <barryleiba@computer.org>, Gen Art <gen-art@ietf.org>, The IESG <iesg@ietf.org>
Message-ID: <55982CC2.2060201@gmail.com>
Date: Sat, 04 Jul 2015 14:58:10 -0400
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:38.0) Gecko/20100101 Thunderbird/38.0.1
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"; format="flowed"
Content-Transfer-Encoding: 7bit
Archived-At: <http://mailarchive.ietf.org/arch/msg/gen-art/qGvWgfRkZRApQqyid7ioLdwceLQ>
Subject: [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: Sat, 04 Jul 2015 18:58:14 -0000
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?