Re: [mpls] Rtgdir last call review of draft-ietf-mpls-ldp-yang-06

"Kamran Raza (skraza)" <skraza@cisco.com> Mon, 23 December 2019 18:10 UTC

Return-Path: <skraza@cisco.com>
X-Original-To: mpls@ietfa.amsl.com
Delivered-To: mpls@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 81003120CA9; Mon, 23 Dec 2019 10:10:11 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -14.501
X-Spam-Level:
X-Spam-Status: No, score=-14.501 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, 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 header.b=GHt4O/Q/; dkim=pass (1024-bit key) header.d=cisco.onmicrosoft.com header.b=mSv42MlV
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 HYghZzAz2UUi; Mon, 23 Dec 2019 10:10:09 -0800 (PST)
Received: from rcdn-iport-1.cisco.com (rcdn-iport-1.cisco.com [173.37.86.72]) (using TLSv1.2 with cipher DHE-RSA-SEED-SHA (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id CC64E120C8E; Mon, 23 Dec 2019 10:10:08 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=cisco.com; i=@cisco.com; l=7440; q=dns/txt; s=iport; t=1577124609; x=1578334209; h=from:to:cc:subject:date:message-id:references: in-reply-to:content-id:content-transfer-encoding: mime-version; bh=mJl38ONM9Dodceobw0wL+4r/6o6MZoAs014elKfp8nE=; b=GHt4O/Q/GXrnlZN4NVEnOkPk6hPwYE8T/uWaIBxCidyO9yOfy8zLOw1O JbBLH5ajHXPoikvyBfovlNqKQ99uFEPkrxVKjEamEavbxoIvxRCt+ijza f22IsqCxQtz6EGtGdSdyHpzbCN8Mn/rEQUBsCZ46V2QSZMMkXOVIh5ZxF A=;
IronPort-PHdr: =?us-ascii?q?9a23=3AcTep7BN9/besm+lCo1Ml6mtXPHoupqn0MwgJ65?= =?us-ascii?q?Eul7NJdOG58o//OFDEuKQ/l0fHCIPc7f8My/HbtaztQyQh2d6AqzhDFf4ETB?= =?us-ascii?q?oZkYMTlg0kDtSCDBjgL+TjfSUSF8VZX1gj9Ha+YgBY?=
X-IronPort-Anti-Spam-Filtered: true
X-IronPort-Anti-Spam-Result: =?us-ascii?q?A0A3DwDlAQFe/49dJa1lHQEBAQkBEQU?= =?us-ascii?q?FAYF8gVJQBWxYIAQLKoQIg0YDinmCOiWTG4RtgUKBEANUCQEBAQwBARgLCgI?= =?us-ascii?q?BAYRAAheCByQ4EwIDDQEBBAEBAQIBBQRthTcMhV8CAQMBARAREQwBASwLAQ8?= =?us-ascii?q?CAQYCFAYCJgICAiULFRACBAENBSKDAAGCRgMuAQIMkR6QZAKBOIhhdYEygn4?= =?us-ascii?q?BAQWFFxiCDAmBDiiMGRqCAIERJwwUUYF7PoJZCwEBgUsYF4J5MoIskDqeWgq?= =?us-ascii?q?CNIczgiaIHoQiG4JGdocFBYQ8i1WOUohSkgQCBAIEBQIOAQEFgWkigVhwFTs?= =?us-ascii?q?qAYJBCUcYDY0Sg3OFFIU/dAGBJ49BAQE?=
X-IronPort-AV: E=Sophos;i="5.69,348,1571702400"; d="scan'208";a="686101854"
Received: from rcdn-core-7.cisco.com ([173.37.93.143]) by rcdn-iport-1.cisco.com with ESMTP/TLS/DHE-RSA-SEED-SHA; 23 Dec 2019 18:10:06 +0000
Received: from XCH-RCD-006.cisco.com (xch-rcd-006.cisco.com [173.37.102.16]) by rcdn-core-7.cisco.com (8.15.2/8.15.2) with ESMTPS id xBNIA3sJ008013 (version=TLSv1.2 cipher=AES256-SHA bits=256 verify=FAIL); Mon, 23 Dec 2019 18:10:05 GMT
Received: from xhs-rtp-003.cisco.com (64.101.210.230) by XCH-RCD-006.cisco.com (173.37.102.16) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Mon, 23 Dec 2019 12:10:02 -0600
Received: from xhs-aln-002.cisco.com (173.37.135.119) by xhs-rtp-003.cisco.com (64.101.210.230) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Mon, 23 Dec 2019 13:10:01 -0500
Received: from NAM11-CO1-obe.outbound.protection.outlook.com (173.37.151.57) by xhs-aln-002.cisco.com (173.37.135.119) with Microsoft SMTP Server (TLS) id 15.0.1473.3 via Frontend Transport; Mon, 23 Dec 2019 12:10:01 -0600
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=SbNP6NG6nBiR2sO1jduvNVeorenLr3rpvRvYPxsT7eDyMZmplV6NH+KQm8FWMTLXWuiHtxFLxreTJnHehakKdh8ITGHVWLcKKVU6gf2RHBXp5Zzhp4Kvgm0zgO0ZlYXV2vTCR9nzwAsT+/S6dWIuXIRXn5WNmFDD+jAxUvbr+iKmwHDC4Ss/nxGfA+CffIY/a1KFlWrG7A6Ry2H3NYrU/kdJt4hQXyTFlYsi8ZbM889tI5zpTt3L9YcWqsOMM8O6QnJEVE+r7ed+pkkaZ/LGqKafOLk8L2cPIkHQLKGSAuTKpRq+GRhQSHFcBTpabAaSbA1ofgQDo9/il1qISLFq6A==
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=mJl38ONM9Dodceobw0wL+4r/6o6MZoAs014elKfp8nE=; b=ND6F8vyN50AzaDRG7oRynJrfyAlxSs5aNIzAzzisHrZUn9v0N34BB9wdHpijrztidt7M4+E/oIGwLUuuXYrpzPK19MGRFkmxyyw9XuE/bqgmgomWcyD1HXqUFMCw996tGlFpUfpll8JdVDsDk+IfYilFCxpecE4PFO4Dok6cRQd7PCcgezoB12oR1w2MHij/D7xZgcdQl+OLteSlI2BhKf5mqntWjp5zdEaCfjFJ4qWJmptSZ7RPk9GIWki+IV26WI7RccK+wMcHzs92bzw62iF41CljUMUZHwWiGq4svd6n4t1hzvG3veKOrmMoUiQjb575Y+m9kHcCx4zDjCF+lA==
ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=cisco.com; dmarc=pass action=none header.from=cisco.com; dkim=pass header.d=cisco.com; arc=none
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cisco.onmicrosoft.com; s=selector2-cisco-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=mJl38ONM9Dodceobw0wL+4r/6o6MZoAs014elKfp8nE=; b=mSv42MlVtpRiMOj2A9UAyWsO7iMpfDPr5WwQyc4Bo7WB/ruxkvpExArMkBTv7ntVKyKRATKn3NWVKhtEZglanySSPUQ4DAQV01ufNu5WJ9UVJV6ctkECZdzw8pDSe+H37FrD0xuGNBeIE4RByEbUsw8okbRurPSG6YOv28IMEtM=
Received: from DM6PR11MB3865.namprd11.prod.outlook.com (20.176.127.159) by DM6PR11MB4393.namprd11.prod.outlook.com (10.255.9.97) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2559.16; Mon, 23 Dec 2019 18:10:00 +0000
Received: from DM6PR11MB3865.namprd11.prod.outlook.com ([fe80::8955:6ce6:45c6:77ed]) by DM6PR11MB3865.namprd11.prod.outlook.com ([fe80::8955:6ce6:45c6:77ed%6]) with mapi id 15.20.2559.017; Mon, 23 Dec 2019 18:10:00 +0000
From: "Kamran Raza (skraza)" <skraza@cisco.com>
To: Yingzhen Qu <yingzhen.ietf@gmail.com>, "rtg-dir@ietf.org" <rtg-dir@ietf.org>
CC: "last-call@ietf.org" <last-call@ietf.org>, "draft-ietf-mpls-ldp-yang.all@ietf.org" <draft-ietf-mpls-ldp-yang.all@ietf.org>, "mpls@ietf.org" <mpls@ietf.org>, "draft-ietf-mpls-ldp-yang@ietf.org" <draft-ietf-mpls-ldp-yang@ietf.org>
Thread-Topic: [mpls] Rtgdir last call review of draft-ietf-mpls-ldp-yang-06
Thread-Index: AQHVkPrtSFVT/VRN5kWhAut026cEkKfIApcA
Date: Mon, 23 Dec 2019 18:09:59 +0000
Message-ID: <888D8635-4482-4666-B257-1375E9C86481@cisco.com>
References: <157264352652.31784.14618175935712783529@ietfa.amsl.com>
In-Reply-To: <157264352652.31784.14618175935712783529@ietfa.amsl.com>
Accept-Language: en-CA, en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
user-agent: Microsoft-MacOutlook/10.1e.0.191013
authentication-results: spf=none (sender IP is ) smtp.mailfrom=skraza@cisco.com;
x-originating-ip: [2001:420:2840:1250:4c27:6c90:817d:cf21]
x-ms-publictraffictype: Email
x-ms-office365-filtering-correlation-id: 85240626-b0da-48e9-90a8-08d787d35334
x-ms-traffictypediagnostic: DM6PR11MB4393:
x-microsoft-antispam-prvs: <DM6PR11MB439376ABE1EC132C94F5A623D02E0@DM6PR11MB4393.namprd11.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:10000;
x-forefront-prvs: 0260457E99
x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(39860400002)(376002)(396003)(346002)(136003)(366004)(199004)(189003)(2906002)(5660300002)(91956017)(8936002)(66476007)(33656002)(64756008)(66446008)(76116006)(966005)(316002)(66556008)(66946007)(110136005)(478600001)(36756003)(186003)(71200400001)(4326008)(54906003)(6506007)(6486002)(2616005)(8676002)(81166006)(6512007)(86362001)(81156014); DIR:OUT; SFP:1101; SCL:1; SRVR:DM6PR11MB4393; H:DM6PR11MB3865.namprd11.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX:1;
received-spf: None (protection.outlook.com: cisco.com does not designate permitted sender hosts)
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: wwb5GnPD8ruiapjMhhIr8Pjr0CMoTBa1jyFYrFu6zHqbAZm5TGAzqYhpEOx/5u77GI0nU8/NIoogQ7w4dACLVL7ruCv4R94o+QB1DSg5SMk95q7+TI5yAxxUylZTMfyXEZ5qRdd+j0VFSOUims9fjnFNpcXNIt2pqGdrGPd9I/Z2GRDCfRzAPfxxnnb7bIspf54jmRJxmWSwa1NEqm5AjTWt4qaJz3OM19FG8GUbfBLGAPqh4MGnkUoBH7gfenlu08SCtgNYzsx5/XmCOFX2TBie8mK1+WYMV+/titfscyK+OxjDXly9mlT7FiI7lv0t6YmT1HxSqesU/2TypTIESJxAwpQA3BvHl04XYwJMUJoSJu+fm+JrV6pbJSMIgxpA/E2+TeQ9Zdk+Qqzon8ye8C33azso1evO3gRuBMCY3qHPtPDIvn/TAwSKuVJSL6lHrqn2fy2a/5r4sRq8tfWhM3Bz/ECixgtboPJtnDLsAfo=
x-ms-exchange-transport-forked: True
Content-Type: text/plain; charset="utf-8"
Content-ID: <F85A890E553FFD41B5EC3F66D8CA0EBF@namprd11.prod.outlook.com>
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-MS-Exchange-CrossTenant-Network-Message-Id: 85240626-b0da-48e9-90a8-08d787d35334
X-MS-Exchange-CrossTenant-originalarrivaltime: 23 Dec 2019 18:09:59.8208 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: 5ae1af62-9505-4097-a69a-c1553ef7840e
X-MS-Exchange-CrossTenant-mailboxtype: HOSTED
X-MS-Exchange-CrossTenant-userprincipalname: mzWjvqI3TdFMedL3UFCtvjYcQkN1XgdbJstkzu4RWOJ6VzrMbXfaE/JQQi5Jxfe5oiv8JqMpFPVJgmwt0KZL4A==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM6PR11MB4393
X-OriginatorOrg: cisco.com
X-Outbound-SMTP-Client: 173.37.102.16, xch-rcd-006.cisco.com
X-Outbound-Node: rcdn-core-7.cisco.com
Archived-At: <https://mailarchive.ietf.org/arch/msg/mpls/87IMOOUltpVX5R4azjvvuxvBwiE>
Subject: Re: [mpls] Rtgdir last call review of draft-ietf-mpls-ldp-yang-06
X-BeenThere: mpls@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Multi-Protocol Label Switching WG <mpls.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/mpls>, <mailto:mpls-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/mpls/>
List-Post: <mailto:mpls@ietf.org>
List-Help: <mailto:mpls-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/mpls>, <mailto:mpls-request@ietf.org?subject=subscribe>
X-List-Received-Date: Mon, 23 Dec 2019 18:10:11 -0000

Hi Yingzhen,

Thanks for your detailed review. We are addressing your comments as well as YD comments and plan to spin a new rev in new year.
Please see our response inline - tagged as [skraza]

On 2019-11-01, 5:25 PM, "mpls on behalf of Yingzhen Qu via Datatracker" <mpls-bounces@ietf.org on behalf of noreply@ietf.org> wrote:

    Reviewer: Yingzhen Qu
    Review result: Has Issues
    
    I have been selected as the Routing Directorate reviewer for this draft. The
    Routing Directorate seeks to review all routing or routing-related drafts as
    they pass through IETF last call and IESG review, and sometimes on special
    request. The purpose of the review is to provide assistance to the Routing ADs.
    For more information about the Routing Directorate, please see
    http://trac.tools.ietf.org/area/rtg/trac/wiki/RtgDir
    
    Although these comments are primarily for the use of the Routing ADs, it would
    be helpful if you could consider them along with any other IETF Last Call
    comments that you receive, and strive to resolve them through discussion or by
    updating the draft.
    
    Document: draft-ietf-mpls-ldp-yang
    Reviewer: Yingzhen Qu
    Review Date: Nov 1st, 2019
    Intended Status: Standards Track
    
    Summary:
    
    This document is near ready for publication. It has some issues that should be
    at least considered prior to publication.
    
    Comments:
    
    Thanks for working on this draft. As an active YANG contributor I appreciate
    the work here.
    
    Major issues:
    
    I’m not sure whether this should be considered as a major issue, which is how
    the document is structured. The draft separates the configuration and operation
    states into two sections, and this seems to be a before NMDA product and a bit
    redundant to me. The tree structures are used in different ways multiple times
    in the document, and this significantly reduces the readability of the modules.
    
[skraza]: Ack. Will fix.

    Minor Issues:
    
    I feel the English in this draft could be improved, but I’m not a native
    speaker. Maybe RFC editor will help with this?
    
    It seems that “model” and “module” are used exchangeable in this document,
    please make them consistent.
    
[skraza]: Ack. Will fix.

    “YANG” should be capital cased, and there are “yang” at multiple places in this
    document. Please fix them.
    
[skraza]: Ack. Will fix.

    Please consider add names to figures.

[skraza]: Ack. Will fix.
    
    I understand inheritance is an important feature of document. I’d suggest maybe
    add a section/paragraph in “overview” to introduce the concept and how it works
    instead of repeating the idea with examples in every major container design.


 [skraza]: Ack. Will see how to address this.   

    Nits for your consideration:
[skraza]: Ack to all the below nits - will fix.

Rgds-
--
Kamran (on behalf of authors)     

    Section 1.1
    Whereas, the "extended" category contains all other non-base features.
    Please consider remove “all” because not all other features are covered.
    
    Section 3
    extended "ietf-mpls-ldp-extended" module that models the extended
          LDP features and augments the base LDP
    Please consider removed “extended” at the beginning, and add “module” at the
    end, “augments the base LDP module”.
    
    There are four main containers in our module(s):
    I suppose you meant “four types of containers”?
    
    Section 4
    under LDP base and extended.
    Please add a “module” at the end.
    
    Section 5
    Following is the high-level configuration organization for base LDP:
    Please add a “module” at the end.
    
    Typo in figure 3 “targeteted”
    
    Typo in figure 4 “targeteted”
    
    Given the configuration hierarchy, the model allows inheritance such
       that an item in a child tree is able to derive value from a similar
       or related item in one of the parent.
    for grammar, it should be “one of the parents”, but this sentence is a bit
    confusing. I’d suggest add a bit more explanation how inheritance work.
    
    5.1.1
    Missing period “.” at the end of the first sentence.
    
    The tree showing here is not a complete tree, just want to make sure whether
    this is intentional?
    
    5.1.2
    Missing period “.” at the end of the first sentence.
    
    5.2.1.1
    “LSR id” and “LSR Id” both are used here, please keep them consistent.
    
    5.2.1.5
    Missing “.” at the end of the first paragraph.
    
    “A peer is uniquely identified using its
     LSR Id and hence LSR Id is the key for peer list”
    Please consider simplify the sentence to “A peer is uniquely identified by its
    LSR Id.”
    
    Section 6
    “  Operational state of LDP can be queried and obtained from read-only
       state containers that fall under the same tree (/rt:routing/
       rt:control-plane-protocols/) as the configuration.”
    This sentence is a bit confusing. Please consider revise it.
    
    _______________________________________________
    mpls mailing list
    mpls@ietf.org
    https://www.ietf.org/mailman/listinfo/mpls