Re: [netconf] Yangdoctors last call review of draft-ietf-netconf-crypto-types-18

Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> Tue, 20 April 2021 12:40 UTC

Return-Path: <J.Schoenwaelder@jacobs-university.de>
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 A486C3A20E7; Tue, 20 Apr 2021 05:40:01 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.9
X-Spam-Level:
X-Spam-Status: No, score=-1.9 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, MSGID_FROM_MTA_HEADER=0.001, RCVD_IN_MSPIKE_H2=-0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=jacobsuniversity.onmicrosoft.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 K8TOdbj1sLtZ; Tue, 20 Apr 2021 05:39:57 -0700 (PDT)
Received: from EUR04-DB3-obe.outbound.protection.outlook.com (mail-eopbgr60060.outbound.protection.outlook.com [40.107.6.60]) (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 DABC83A2286; Tue, 20 Apr 2021 05:39:17 -0700 (PDT)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=KN62Q81yvurp3nT+BMpf8opClViokLxCP/ZB5Utjqbow4VCWWvDirupfXVSjPEk5kkQFMUG+Ew+VVyWd9jddKIdR/Tn4fShe67oHsdKLFL2NpDQZ5WgZgvdq6ODGOdY1SGsH9mL8ehgJ2PXnXAbzREAmVYkX3yoBanFG6zF4aKTOyn1D5ar0syaSLRBcGsJ3YHO8+uGJOBfJfDQ3FZKquuHl1fKY8kz2s/xsB0+7TvVEDlbGHSya1ZEuW4nGyemDpDgpee5UHwg4hAKRt430gVtTvh1ErcneBsLpuKMDrrI/qwaaAmoUxMtRLrei+g4Iu4HdTUcHAqO41q7aQ7kDBg==
ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=1ykAiXmfPXz2j1iHAPuKhN4NzGHQvl6NOdLwzgJI+Lo=; b=EzwaTly6bM4bhHk8Gy1FNhs/PqcA0/pT4kyymKRcHuQQx4hcipTQkcKL+kF6ajrvsuhPbkSumjaqya6JCZaXVuyb7dp3M542lLdtnqquU1zHv3lI4ZQ3EpCFQ6kuUuBBPAI5pseHhVPjoHn3zb7kQhZP0Rdhvgl+znmhsHklUAeG9wCcJY++sv2AEomDhpYdsfJlRjm07odU3BYaQ6GyewfXHQK6PAumfHh7l9UeqrLn9/eHAVJWhAhqwgJRhMEnGPSAl4qBfa1uQB1RntgKsBkGbnX8s5N/T9MyY6z1jgmmiIuw9YoW77B5Uej2iG9J3hQsOpZvBpOdTaOWZfC5QQ==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=jacobs-university.de; dmarc=pass action=none header.from=jacobs-university.de; dkim=pass header.d=jacobs-university.de; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=jacobsuniversity.onmicrosoft.com; s=selector2-jacobsuniversity-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=1ykAiXmfPXz2j1iHAPuKhN4NzGHQvl6NOdLwzgJI+Lo=; b=mcfifW5DA5M70KHRSASxEJBUFP/10mcKrRbQQ1/8/RonT0bjhPTxyCeXR9aWe6kG2JxwFIG+o9XABENgrHnwgdbOVaA1gJdYjDjD+tza/6bfnDssQ1QHDUyE785vrLlGJVA8C5D32bApbXObf0v1PwzdHVSMKTyQawvk+oCBQfw=
Authentication-Results: watsen.net; dkim=none (message not signed) header.d=none;watsen.net; dmarc=none action=none header.from=jacobs-university.de;
Received: from AM0P190MB0641.EURP190.PROD.OUTLOOK.COM (2603:10a6:208:194::23) by AM0P190MB0692.EURP190.PROD.OUTLOOK.COM (2603:10a6:208:195::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4042.16; Tue, 20 Apr 2021 12:39:15 +0000
Received: from AM0P190MB0641.EURP190.PROD.OUTLOOK.COM ([fe80::e8a2:9886:8dfa:41c6]) by AM0P190MB0641.EURP190.PROD.OUTLOOK.COM ([fe80::e8a2:9886:8dfa:41c6%4]) with mapi id 15.20.4042.024; Tue, 20 Apr 2021 12:39:15 +0000
Date: Tue, 20 Apr 2021 14:39:13 +0200
From: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
To: Kent Watsen <kent+ietf@watsen.net>
Cc: "netconf@ietf.org" <netconf@ietf.org>, YANG Doctors <yang-doctors@ietf.org>
Message-ID: <20210420123913.74ejllmgty5z2w6k@anna.jacobs.jacobs-university.de>
Reply-To: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
Mail-Followup-To: Kent Watsen <kent+ietf@watsen.net>, "netconf@ietf.org" <netconf@ietf.org>, YANG Doctors <yang-doctors@ietf.org>
References: <161045360252.14510.16755799701987783827@ietfa.amsl.com> <010001778e67638b-53d8c33f-82f6-4bda-881a-3cf881c06c95-000000@email.amazonses.com> <20210416115004.fqhitq6jofc6vjih@anna.jacobs.jacobs-university.de> <01000178ec7bfedf-5b8a2940-2fdd-42f5-ae43-27277d991769-000000@email.amazonses.com>
Content-Type: text/plain; charset=utf-8
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <01000178ec7bfedf-5b8a2940-2fdd-42f5-ae43-27277d991769-000000@email.amazonses.com>
X-Originating-IP: [212.201.44.244]
X-ClientProxiedBy: PR3P189CA0087.EURP189.PROD.OUTLOOK.COM (2603:10a6:102:b4::32) To AM0P190MB0641.EURP190.PROD.OUTLOOK.COM (2603:10a6:208:194::23)
MIME-Version: 1.0
X-MS-Exchange-MessageSentRepresentingType: 1
Received: from localhost (212.201.44.244) by PR3P189CA0087.EURP189.PROD.OUTLOOK.COM (2603:10a6:102:b4::32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4042.16 via Frontend Transport; Tue, 20 Apr 2021 12:39:14 +0000
X-MS-PublicTrafficType: Email
X-MS-Office365-Filtering-Correlation-Id: ef132f12-a60b-4371-caba-08d903f94ea0
X-MS-TrafficTypeDiagnostic: AM0P190MB0692:
X-MS-Exchange-Transport-Forked: True
X-Microsoft-Antispam-PRVS: <AM0P190MB0692DE083BDED439F5435E80DE489@AM0P190MB0692.EURP190.PROD.OUTLOOK.COM>
X-MS-Oob-TLC-OOBClassifiers: OLM:10000;
X-MS-Exchange-SenderADCheck: 1
X-Microsoft-Antispam: BCL:0;
X-Microsoft-Antispam-Message-Info: x5I3o6wO1qxTGBPEm9N+wt07sPn5zvRS5x8+Fzo4DHxqOBrZBBU6gxa/odDFHLbpseeBEW2vmUsIRBDA41nqjmcCnAH4WLN+wvGArxdikF+venXNtOqUbc8pllv82IDQPbXpRgGewJB6AdCRmmZuhNxmbnvYy9MpsThsLRRd0a04ySWRtKAmj50jHCeit7DEeySvrEcSg1kv5Tx2xfVzF9CIaPpmd5XF5C1FzYfvlW7eKV3cJCRfQZ/kPhao3VltbEgoSZDjAaFN+FSlpvCd+RHZgWz3oeoVOr598F/J7X6m8gg913wnBhlBT/U9fxsUa+ko/sxeNMQex0iWLsTQL62KOAcTrdovCsc/rlbkT5+5ImRjJaplVi+JKdR28FL73C2wHGAJJmDlxMuxm/neY3VwPKV6XJ+wtYAJx2rNHSse1D4OpsPleugb3IXW3NmDeNZ7TEiVHnzkcGPHU3tt4zdva24gvnZRgKtm+v/BLtep/W2KgcVV1BIm08urW0Zuv++DHgTiq1kX4RVBzu/+RujqXyZvBCDFuRmdWMZVXAdZC4p80thxdKkNsxvtg/6xC6F1fTC3hjJGyeUsjb2JbeLrOzAG5eYsMXJfyMGfF2TczBMYNNyWM6RoAUFDx+Z5a0LDu14bx+YU+PyLBcLfIblCC65JDVVwTz1fDxSkYwPxzQOWpaDl5cIp1hgp+LFzg4+/WewSXQKo5U6/qXUv/OOzZbC7WqcGKCskmwYR0bqMimJ6L3e9WIiQj1bhnOOl
X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:AM0P190MB0641.EURP190.PROD.OUTLOOK.COM; PTR:; CAT:NONE; SFS:(366004)(498600001)(16526019)(26005)(52116002)(6486002)(38350700002)(6496006)(5660300002)(66476007)(2906002)(186003)(86362001)(956004)(4326008)(83380400001)(38100700002)(54906003)(8936002)(66556008)(66946007)(8676002)(3450700001)(1076003); DIR:OUT; SFP:1101;
X-MS-Exchange-AntiSpam-MessageData: =?utf-8?B?L3pyNlVub05SWnBDQkZqSWlackRyeTdOTkp1MU5MelQ3U2hhOTRmTGlidDRF?= =?utf-8?B?TXlmMEdyczR5ZW1FdUlRUmxGVnQxaXRBOC9oMDFhdXNTYzQ4enlZWjZTNkNI?= =?utf-8?B?L0d2UXZsOGFHQitXaUViMkMzQkNzQTRUei9HTjRHOTVpRnorMDBlOS9hN2Nw?= =?utf-8?B?aGtGbFVsb2FNVFZjUmRLVG5oeGFjQ2huNGFsTml4aS9JMUEvZkZEVzhKVnNX?= =?utf-8?B?bDFVN3ZFblpKRm4wTklxUERUcWRIZzBOMTU2RExKQ0FxS1lLOVoxR0JOcGNS?= =?utf-8?B?eEkxbDhFVzJ5anMvYXEvZjZIbGg2Yk1PNlp2czlnY0U2bklranBsRFRKSFk4?= =?utf-8?B?V3YvQ0ZYNHlZY1l6VHpQRG1Pc1VIQm93UUV3amFuSlliUnpuM3pkRGN1ODhL?= =?utf-8?B?M0UwUFBRcm5lVkFRZmMzVnRUZTk4Y2ExT01HVVBaa3A1Vy9QRDhDV2VzQk5i?= =?utf-8?B?UlpQalNBZ2RrQWR5Qm9UNG1NeHN4RHljVnNxcjJ3NlZ6ZVhqRGNqOEVFeUpP?= =?utf-8?B?NVNPb0E3dS9ManhYVHBLb2RCQ29peExBK1oxUGtSRkNjUHNybUswaVZCalVY?= =?utf-8?B?QWc5WWJ5RjVmdkNQRWhDdXZPZ1NOZlhNcUZINHVmTVNadVRvOXRSdWpYQlZI?= =?utf-8?B?cC81ci9kM2w3QzY0dDNiZ3dOYWJaa3p2Wjg2T2syQ25QSHRVSm5TNnhzY3Vk?= =?utf-8?B?eEg4TkhObk9WY2c3ZHZGbWJpRmNHWld3UjdmUG9TS01NRkxOKytIcmR5SjFH?= =?utf-8?B?YVZiZDBrVEloRWF2UG8rbXU2N09WN1d0R2JHRW1CREd2N3ZXdzhBSUM2U1hC?= =?utf-8?B?R2pGNERqRkM4Z2hIUjlETFRFNDNiY0hHa055ZTJVVEl0TGpld1VDQmM3Nmpt?= =?utf-8?B?VkhDd2FJVS93R3RUSE5DUHN6TkgrQVNLSzE1a1ZUeWlLYXdsbW4zUEZhUWpF?= =?utf-8?B?VjhFN21QdjY5b0JCdjY3YzFlZ0xvalNaY3FoTkM5YXRtc25pbjJ2NUNVRVhw?= =?utf-8?B?WVV4ZjluSHc5VHlDRGxoUmNuWTJoMzJ0dThjZDRxQTRKcTBSR05Razd6UmNm?= =?utf-8?B?M3ViSmFnSkhRMXhyR3U1dEhmd1ZDQ1BQbHl3RWZqWjlzaExwVCtIVlA4eVcz?= =?utf-8?B?NTJ3UHhHdzFpMnkwakdXRCtnVXhNc09WSmxFeXkwUWh5MTE1WVR3NjlhWGxv?= =?utf-8?B?UEVkYUVFSWgrT3ZSUkwwQjRKTlUxb3JWYzh1cFIxdlFSRXM0clR0ejIwcVpM?= =?utf-8?B?cTJxZG1XYzlheFF4MWxXZ2htejluUUcySFpKNEkxb3ZHRkNyd3ZCcDNWMllo?= =?utf-8?B?dnNpVTYySVBUMXBVekkxUkhSblYyMDUxc3lMOUU4MGhPSkhjSHJUY2wyanYr?= =?utf-8?B?OEZ6TU1zUnB4WUNTQzlPNHpYN3dWanZXeHBhWllqNmxsYkphUHN0NFpDN3d3?= =?utf-8?B?VWpMS2VqYXdTa0hKY1RwRGhodW9WZ2lSL1JJWk5VdmNoZDMzdmtxSmdSdVhx?= =?utf-8?B?bnF2RmdXQmsrT0xsTmNIZytQVjlNYmQvNzlVSmFHRjJRT3diVXBQaFlMQVMw?= =?utf-8?B?VEpINlcwVjhMRDYvOUhmZHZXRE9sL1g2UlhNdnZUekVCYU4wVjkzS01YWWxC?= =?utf-8?B?czhKQ3JyVGxIY1Z4eHliLzBmMVVYVVdyMTdmNEFoMllaMHNrN3lrSjZmSHFm?= =?utf-8?B?Y3FPUXFrQ255d2FQT1U5MkRnclJ2Nk1jR0FHR0ZvcUZsZy90dVJlbUNlWTkv?= =?utf-8?Q?G7hj9XR/GXpgwy1WjX3yZkG4znLze3dWwl6SvUP?=
X-OriginatorOrg: jacobs-university.de
X-MS-Exchange-CrossTenant-Network-Message-Id: ef132f12-a60b-4371-caba-08d903f94ea0
X-MS-Exchange-CrossTenant-AuthSource: AM0P190MB0641.EURP190.PROD.OUTLOOK.COM
X-MS-Exchange-CrossTenant-AuthAs: Internal
X-MS-Exchange-CrossTenant-OriginalArrivalTime: 20 Apr 2021 12:39:15.1970 (UTC)
X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted
X-MS-Exchange-CrossTenant-Id: f78e973e-5c0b-4ab8-bbd7-9887c95a8ebd
X-MS-Exchange-CrossTenant-MailboxType: HOSTED
X-MS-Exchange-CrossTenant-UserPrincipalName: hPmUZ+w3ZE93HAgmR9D6+FIMSgZp2343BQM/Z0Tn+ps+5AxypqUUUV8AivUSGhD17WedzENEJXLiXFetOWOtnjapcD3hGnk+nRxtVcBH18I=
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0P190MB0692
Archived-At: <https://mailarchive.ietf.org/arch/msg/netconf/B8uZRSpxAyLiHzanjLl_EIt2kS8>
Subject: Re: [netconf] Yangdoctors last call review of draft-ietf-netconf-crypto-types-18
X-BeenThere: netconf@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: NETCONF WG 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, 20 Apr 2021 12:40:02 -0000

On Mon, Apr 19, 2021 at 11:34:12PM +0000, Kent Watsen wrote:
> 
> Hi Juergen,
> 
> Whittling out things resolved...
> 
> K.
> 
> > 
> >> - Does it make sense to have a new notation like
> >>> 
> >>>     |  The diagram above uses syntax that is similar to but not
> >>>     |  defined in [RFC8340].
> >>> 
> >>> or shall this simply become regular text?
> >> 
> >> I find using tree-diagram like notation for features, identities, and typedefs helpful, especially in showing the “if-feature” constraints and hierarchical relationships between items.  I recommend adding these enhancements to RFC 8340.  It would be helpful if someone could whip up an I-D so these documents could reference the I-D instead of having the "The diagram above uses syntax that is similar to but not defined in [RFC8340]” language.
> >> 
> >> That said, I also used a "rfc8340-like" diagram to list all the groupings in a module.  It seems like the consistent thing to do, but I can’t imagine the RFC 8340 being updated to support that output, so I replaced that diagram, with a normal "xml2rfc" list, in the entire suite of drafts.
> > 
> > I am sorry, I should have been clearer. My comment did not concern the
> > diagrams but the mere fact that you have
> > 
> >      |  The diagram above uses syntax that is similar to but not
> >      |  defined in [RFC8340].
> > 
> > instead of simply
> > 
> >   The diagram above uses syntax that is similar to but not
> >   defined in [RFC8340].
> > 
> > and this is really an editorial nit if at all. The diagram itself I
> > like, it would be nice to have them in RFC 8340bis.
> 
> Ah, now I understand, you mean to remove the XML2RFC v3 “aside”?  I agree that it renders poorly in plain-text, but it renders inside a pretty-box for HTML and PDF.  Thoughts?

Ah, its called an "aside". I am still reading plain-text but the
question likely is what belongs into an aside box and what into
text. For me, there is no reason to put this sentence into an 'aside'
box - whatever the purpose of such a box is. Its just a regular
sentence for me.
 
> Yes, the diagrams would be a nice addition to an 8340bis.  Also, I don’t know if you noticed, but the “Data Model Overview” section I created in all these drafts is highly mechanical…something that could be mostly automated…perhaps a good student project?  ;)

Students tend to do something half and then disappear. ;-) 

/js

-- 
Juergen Schoenwaelder           Jacobs University Bremen gGmbH
Phone: +49 421 200 3587         Campus Ring 1 | 28759 Bremen | Germany
Fax:   +49 421 200 3103         <https://www.jacobs-university.de/>