Re: [netmod] WG adoption poll draft-kwatsen-netmod-artwork-folding-08

Robert Wilton <rwilton@cisco.com> Wed, 24 October 2018 08:40 UTC

Return-Path: <rwilton@cisco.com>
X-Original-To: netmod@ietfa.amsl.com
Delivered-To: netmod@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 94D8F130DEB; Wed, 24 Oct 2018 01:40:38 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -14.97
X-Spam-Level:
X-Spam-Status: No, score=-14.97 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.47, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_HI=-5, SPF_PASS=-0.001, USER_IN_DEF_DKIM_WL=-7.5] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=cisco.com
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 xBKfHnRp62ZJ; Wed, 24 Oct 2018 01:40:36 -0700 (PDT)
Received: from aer-iport-1.cisco.com (aer-iport-1.cisco.com [173.38.203.51]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 9718112870E; Wed, 24 Oct 2018 01:40:31 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=5891; q=dns/txt; s=iport; t=1540370431; x=1541580031; h=subject:to:cc:references:from:message-id:date: mime-version:in-reply-to; bh=z2QjShVo3avM9vrCNgajEEPIh9p+htM+Xae7vAO32WE=; b=j5KskfE82f2VIWsPeUrTSy2HoL1hWQljQMcnt5TrykRle7RyNXpBHMSY igxs88Ab8jYAHxJTOnS7klFnRCwaf8oLUV4UgvMMWow6MY+nMMBnMYVEY TJd92Cu00hO9RW1bAkSOMqBpEEYcZx1DWKvEEjHZpRNIXgrgW1vAVHrC6 0=;
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: =?us-ascii?q?A0A+AADYLtBb/xbLJq1jGQEBAQEBAQE?= =?us-ascii?q?BAQEBAQcBAQEBAQGBZYEOTYEQbRIog3WId40mJZFOh0QNGAEKhANGAoMqOBY?= =?us-ascii?q?BAwEBAgEBAm0cDIU7AQEEAQEhSwsQCw4KKgICJzAGAQwGAgEBgx0BggEPp1+?= =?us-ascii?q?BLh+FHIRmBYt5gUE/gREnDIJfgxsBAYRkglcCjxSPSgmQcgYXiTeGf5Athki?= =?us-ascii?q?BWiGBVTMaCBsVO4JsgzoBCIdWhT8+MIxCAQE?=
X-IronPort-AV: E=Sophos;i="5.54,419,1534809600"; d="scan'208,217";a="7493740"
Received: from aer-iport-nat.cisco.com (HELO aer-core-1.cisco.com) ([173.38.203.22]) by aer-iport-1.cisco.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 24 Oct 2018 08:40:29 +0000
Received: from [10.63.23.63] (dhcp-ensft1-uk-vla370-10-63-23-63.cisco.com [10.63.23.63]) by aer-core-1.cisco.com (8.15.2/8.15.2) with ESMTP id w9O8eSPR006846; Wed, 24 Oct 2018 08:40:29 GMT
To: Martin Bjorklund <mbj@tail-f.com>, kwatsen@juniper.net
Cc: netmod-chairs@ietf.org, netmod@ietf.org
References: <7fe4a6a2-ec5e-1336-d5c0-34fd698e26fb@labn.net> <20181023.101605.216102708295807418.mbj@tail-f.com> <C6C63BB3-2D02-4F3C-9895-332B64A5B1E5@juniper.net> <20181023.203922.2119478315839780523.mbj@tail-f.com>
From: Robert Wilton <rwilton@cisco.com>
Message-ID: <98d3d29f-1048-7ebe-2f29-8513e4f87965@cisco.com>
Date: Wed, 24 Oct 2018 09:40:28 +0100
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:52.0) Gecko/20100101 Thunderbird/52.9.1
MIME-Version: 1.0
In-Reply-To: <20181023.203922.2119478315839780523.mbj@tail-f.com>
Content-Type: multipart/alternative; boundary="------------05F7445D4804A31091FD6344"
Content-Language: en-US
X-Outbound-SMTP-Client: 10.63.23.63, dhcp-ensft1-uk-vla370-10-63-23-63.cisco.com
X-Outbound-Node: aer-core-1.cisco.com
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/2AAsMh_59a8GVYDQzoKdZQb7KCU>
Subject: Re: [netmod] WG adoption poll draft-kwatsen-netmod-artwork-folding-08
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod/>
List-Post: <mailto:netmod@ietf.org>
List-Help: <mailto:netmod-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=subscribe>
X-List-Received-Date: Wed, 24 Oct 2018 08:40:39 -0000


On 23/10/2018 19:39, Martin Bjorklund wrote:
> Kent Watsen <kwatsen@juniper.net> wrote:
>> Hi Martin,
>>
>>> one quick comment; the header used in the examples in
>>> section 8 isn't equal to the header defined in section 5.1
>>
>> This is intentional.  Section 5.1 says:
>>
>>     The first line is the following 46-character string that MAY be
>>     surrounded by any number of printable characters.
> Ok.
>
>> The rationalization here is:
>>
>>    - scripts can easily center the text with equal amounts of some
>>      chosen character.  The script in the Appendix, which was used
>>      to fold examples 8.1 thru 8.4, uses '=' characters.
>>
>>    - manual folding is difficult to center, and hence other framing
>>      is more suitable.  For instance, the example in Section 8.5.
> Ok, but what's the point?  Why not use a fixed header?  IMO it might
> also improve readability by have a common well-known header.
I'm on the fence on this one. I like the idea of having a fixed header 
(and perhaps footer as well), but if they are padded to 72 characters 
then the header may be quite jarring to the surrounding text (e.g. the 
YANG tree diagram example that I provided previously, and reproduced below):

========== NOTE: '\\' line wrapping per BCP XX (RFC XXXX) ===========
  
   module: ietf-if-l3-vlan
      augment /if:interfaces/if:interface/if-cmn:encapsulation/\
                                                    \if-cmn:encaps-type:
        +--:(dot1q-vlan)
           +--rw dot1q-vlan
              +--rw outer-tag!
              |  +--rw tag-type    dot1q-tag-type
              |  +--rw vlan-id     ieee:vlanid
              +--rw second-tag!
                 +--rw tag-type    dot1q-tag-type
                 +--rw vlan-id     ieee:vlanid


Thanks,
Rob

>
>
> /martin
>
> _______________________________________________
> netmod mailing list
> netmod@ietf.org
> https://www.ietf.org/mailman/listinfo/netmod
> .
>