Re: [i2rs] Ignas Bagdonas' Discuss on draft-ietf-i2rs-yang-dc-fabric-network-topology-08: (with DISCUSS and COMMENT)

Martin Bjorklund <mbj@tail-f.com> Tue, 03 April 2018 20:29 UTC

Return-Path: <mbj@tail-f.com>
X-Original-To: i2rs@ietfa.amsl.com
Delivered-To: i2rs@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id CBA3F12D870; Tue, 3 Apr 2018 13:29:36 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.91
X-Spam-Level:
X-Spam-Status: No, score=-1.91 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, SPF_PASS=-0.001, T_RP_MATCHES_RCVD=-0.01, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
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 6JD1HeD42H9X; Tue, 3 Apr 2018 13:29:35 -0700 (PDT)
Received: from mail.tail-f.com (mail.tail-f.com [46.21.102.45]) by ietfa.amsl.com (Postfix) with ESMTP id 2EE42128C0A; Tue, 3 Apr 2018 13:29:35 -0700 (PDT)
Received: from localhost (h-80-27.A165.priv.bahnhof.se [212.85.80.27]) by mail.tail-f.com (Postfix) with ESMTPSA id B5F341AE0312; Tue, 3 Apr 2018 22:29:33 +0200 (CEST)
Date: Tue, 03 Apr 2018 22:29:33 +0200
Message-Id: <20180403.222933.530851196105443807.mbj@tail-f.com>
To: shares@ndzh.com
Cc: ibagdona@gmail.com, iesg@ietf.org, i2rs@ietf.org, draft-ietf-i2rs-yang-dc-fabric-network-topology@ietf.org, i2rs-chairs@ietf.org
From: Martin Bjorklund <mbj@tail-f.com>
In-Reply-To: <006401d3cb53$f17c36d0$d474a470$@ndzh.com>
References: <152275562986.13946.4129194230664503798.idtracker@ietfa.amsl.com> <006401d3cb53$f17c36d0$d474a470$@ndzh.com>
X-Mailer: Mew version 6.7 on Emacs 24.5 / Mule 6.0 (HANACHIRUSATO)
Mime-Version: 1.0
Content-Type: Text/Plain; charset="us-ascii"
Content-Transfer-Encoding: 7bit
Archived-At: <https://mailarchive.ietf.org/arch/msg/i2rs/Z5ZH9mTozeCB53LtGVJPpIJpXxY>
Subject: Re: [i2rs] Ignas Bagdonas' Discuss on draft-ietf-i2rs-yang-dc-fabric-network-topology-08: (with DISCUSS and COMMENT)
X-BeenThere: i2rs@ietf.org
X-Mailman-Version: 2.1.22
Precedence: list
List-Id: "Interface to The Internet Routing System \(IRS\)" <i2rs.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/i2rs>, <mailto:i2rs-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/i2rs/>
List-Post: <mailto:i2rs@ietf.org>
List-Help: <mailto:i2rs-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/i2rs>, <mailto:i2rs-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 03 Apr 2018 20:29:37 -0000

Hi,

Just a quick comment on the YANG doctor's review.

"Susan Hares" <shares@ndzh.com> wrote:
> Earlier feedback (rtg-dir, ops-dir, yang-doctors) on YANG suggested
> taking out the lengthy descriptions regarding logic and history.

It is very common that the YANG doctor review ask for *more* details
in the descriptions.  In general, we want the module to have as much
explanatory text as possible.  So was the case for the YD review for
this document as well; the YD wrote "The descriptions in all YANG
Modules are very short/terse."  That was for the -02 version, and even
the -00 version did not contain lengthy descriptions AFAICT.


/martin