[Netconf] Editorial comments on draft-kwatsen-netmod-artwork-folding-05

"Jonathan Hansford" <jonathan@hansfords.net> Tue, 26 June 2018 15:45 UTC

Return-Path: <jonathan@hansfords.net>
X-Original-To: netconf@ietfa.amsl.com
Delivered-To: netconf@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 00B3A130EBB for <netconf@ietfa.amsl.com>; Tue, 26 Jun 2018 08:45:41 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: 0.722
X-Spam-Level:
X-Spam-Status: No, score=0.722 tagged_above=-999 required=5 tests=[BAYES_50=0.8, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_IMAGE_ONLY_32=0.001, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_NONE=-0.0001, T_REMOTE_IMAGE=0.01, T_SPF_PERMERROR=0.01] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=hansfords.net
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 aPi8AOB55YLr for <netconf@ietfa.amsl.com>; Tue, 26 Jun 2018 08:45:38 -0700 (PDT)
Received: from server.myfast.site (server.myfast.site [212.113.130.90]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id AB5A6130DFF for <netconf@ietf.org>; Tue, 26 Jun 2018 08:45:38 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=hansfords.net; s=default; h=Content-Type:Mime-Version:Reply-To:Message-Id: Date:Subject:To:From:Sender:Cc:Content-Transfer-Encoding:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References:List-Id:List-Help:List-Unsubscribe: List-Subscribe:List-Post:List-Owner:List-Archive; bh=gXMt8wUzRHgj9D3fgUJU/1AoPkylH3yC8QPAfnM9vw8=; b=v+JqCGU7nps2zbiAkVEC9VdIH4 dfEbMdD1DSM3u2BAHxWdir1EyQEoDFfpf98Hf34PkbA/PKp/s5TXqH6opT5wdoodqEH3FVAXgSA96 TT6lMONgNSr4PD88qMwlK8DHEzVJAFuqMCEjLro7rEiUMA2J7tCbix0EwjY547UK1faMAdDUAETe3 xaLe2l8sFHe1iiY2EtmWEvWBSxl0qp5UlHfAK4GO7vlb4WZFWvSODpVsUX/ocT9z1uSeZsZGmfoVi zthCgIYm2HSvp/VVZCN/cbwbAxl//hnJjozoM0OXNtTPo4Pk6JdQHp6I2AtXtjsujH66wsypnOYa0 +WxIl3sQ==;
Received: from [87.242.131.102] (port=60240 helo=[192.168.1.95]) by server.myfast.site with esmtpsa (TLSv1.2:ECDHE-RSA-AES256-GCM-SHA384:256) (Exim 4.91) (envelope-from <jonathan@hansfords.net>) id 1fXq9w-002Vxs-5e for netconf@ietf.org; Tue, 26 Jun 2018 16:45:36 +0100
From: Jonathan Hansford <jonathan@hansfords.net>
To: "netconf@ietf.org" <netconf@ietf.org>
Date: Tue, 26 Jun 2018 15:45:36 +0000
Message-Id: <em6d922c27-30cd-41e3-806d-25669aa83a62@morpheus>
Reply-To: Jonathan Hansford <jonathan@hansfords.net>
User-Agent: eM_Client/7.1.32088.0
Mime-Version: 1.0
Content-Type: multipart/alternative; boundary="------=_MB44601251-CCA7-4006-966B-6658F05FDF5C"
X-Antivirus: Avast (VPS 180626-0, 26/06/2018), Outbound message
X-Antivirus-Status: Clean
X-AntiAbuse: This header was added to track abuse, please include it with any abuse report
X-AntiAbuse: Primary Hostname - server.myfast.site
X-AntiAbuse: Original Domain - ietf.org
X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12]
X-AntiAbuse: Sender Address Domain - hansfords.net
X-Get-Message-Sender-Via: server.myfast.site: authenticated_id: jonathan@hansfords.net
X-Authenticated-Sender: server.myfast.site: jonathan@hansfords.net
Archived-At: <https://mailarchive.ietf.org/arch/msg/netconf/tTSkPwKCNFtJziZH9Mt_D6R6h6E>
Subject: [Netconf] Editorial comments on draft-kwatsen-netmod-artwork-folding-05
X-BeenThere: netconf@ietf.org
X-Mailman-Version: 2.1.26
Precedence: list
List-Id: Network Configuration WG mailing list <netconf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netconf>, <mailto:netconf-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netconf/>
List-Post: <mailto:netconf@ietf.org>
List-Help: <mailto:netconf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netconf>, <mailto:netconf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 26 Jun 2018 15:45:41 -0000

Hi,

Just a few editorial comments on 
draft-kwatsen-netmod-artwork-folding-05:
General:Though there is a header to indicate where the artwork starts, 
there is no footer to indicate where it ends. How would a parser know 
when to stop? Should the header (and footer) be deleted for any artwork 
that does not require folding?Section 4.1: 1st paragraph: A very minor 
issue, but "e.g." and "etc." should not be used in the same list. "e.g." 
is used for a list of examples and by implication isn't complete, 
therefore "etc." is already inferred.2nd paragraph: Not sure what the 
1st sentence is saying. 2nd sentence: s/susceptible is/susceptible to3rd 
sentence: s/fair/fairsSection 4.2, 3rd paragraph, 1st sentence: 
repetition of "out" - one of them needs removingSection 5.2:2nd 
paragraph, 1st sentence: s/than then/than the3rd paragraph, 1st 
sentence: s/be lead/leadSection 5.3:2nd paragraph: 
s/Caluculate/Calculate4th paragraph: Arguably this should be from 
bottom-to-top as, going from top-to-bottom, once you have concatenated 
two lines the '\' will not be on the folding-column
Jonathan

---
This email has been checked for viruses by Avast antivirus software.
https://www.avast.com/antivirus