Re: Yangdoctors last call review of draft-ietf-rtgwg-yang-rib-extend-17

Acee Lindem <acee.ietf@gmail.com> Thu, 04 May 2023 14:53 UTC

Return-Path: <acee.ietf@gmail.com>
X-Original-To: rtgwg@ietfa.amsl.com
Delivered-To: rtgwg@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 8362AC1388B9; Thu, 4 May 2023 07:53:05 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.097
X-Spam-Level:
X-Spam-Status: No, score=-2.097 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_BLOCKED=0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.com
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id 2nN4eTIvlx1A; Thu, 4 May 2023 07:53:03 -0700 (PDT)
Received: from mail-qt1-x82e.google.com (mail-qt1-x82e.google.com [IPv6:2607:f8b0:4864:20::82e]) (using TLSv1.3 with cipher TLS_AES_128_GCM_SHA256 (128/128 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 3EA3CC137386; Thu, 4 May 2023 07:53:03 -0700 (PDT)
Received: by mail-qt1-x82e.google.com with SMTP id d75a77b69052e-3ef657f5702so5008241cf.3; Thu, 04 May 2023 07:53:03 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20221208; t=1683211982; x=1685803982; h=to:references:message-id:content-transfer-encoding:cc:date :in-reply-to:from:subject:mime-version:from:to:cc:subject:date :message-id:reply-to; bh=Qm/Lhr4I+Bon3oklQspUD6s0COYEBjK483axWD4Cdvo=; b=Rv1eV87fgErgUpgnCeO3aRvJE33IR6F3Vd8E98UKCx0Of3PWVzOdU+bi9Pr1hXtqIt if4eCd3Ex2fbrV3XsDdsna2zk9GQN1WeSCiXgoVJ0HVLm0yJNZWvopuuru6O3Cce0I/S MW1870gNSpuznY6Tbs9nWTVvn+8hOVVixpxwJ08E1JRKyy1otUdGoey7TtNW2QRdqGr3 7nVeXjDhrmOotYT5mvwzGKv+nRf+OU3zeUntgt3tjYmCUpZsHMf+OnfnC6aVSKqv2dJ0 /X/WkcdfF5NI6pg3OeWIZe/bLK/VQOU3KU/BpoiciYkMPVTepGExZcMxFeGaFT+A/xE/ 5eZw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1683211982; x=1685803982; h=to:references:message-id:content-transfer-encoding:cc:date :in-reply-to:from:subject:mime-version:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=Qm/Lhr4I+Bon3oklQspUD6s0COYEBjK483axWD4Cdvo=; b=dBC6mvE5Bh7vTOXW5kURZIBcyPFsy4SlK66PX7GiYPO1Yuc3d0gRUIqRLEkne/je8K lqdvJymUaaw8K5GVq6oJAJGJtY22zXEfNDD5rEllWho+jJpWeuju+M4BGykW5dUMszWs mB1fz9sy1rkbQKgPQlKR7XP+7QzZ3gQpHTXveJx9iGWmWRgtV0l2QyRv81KO6jttRa6o 791TSDTZH8BiI76GQLp/Bezkh0p2wAP5J5DUw7iI6y3kZsG1k98pf1fsG8OyypULc6Zr rpn7GW0AzzPEKVPPP9Rw4mOzF/ea2qhhTjfbDERx4c8DqZt93+Z2bamPhb4zGHS7HvvA s/vQ==
X-Gm-Message-State: AC+VfDwf+E3o0sT3dtyU364HWLbbBaPab06kjQMDzAUkvhygeOicvD1p vGpArFa1BiHP+uXD5/vWBCQpj86ALyM=
X-Google-Smtp-Source: ACHHUZ6zgd/TGd16fjjMv0h1a+dNu+QdU+mkOI/jem3YgtQopt26CRdZnDd8blGi5PTE0w+M9JUvrA==
X-Received: by 2002:ac8:7f44:0:b0:3f2:18e8:c766 with SMTP id g4-20020ac87f44000000b003f218e8c766mr5744518qtk.67.1683211982227; Thu, 04 May 2023 07:53:02 -0700 (PDT)
Received: from smtpclient.apple ([136.56.20.4]) by smtp.gmail.com with ESMTPSA id w24-20020a05622a191800b003ef59e2b9a6sm11951769qtc.78.2023.05.04.07.53.01 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Thu, 04 May 2023 07:53:01 -0700 (PDT)
Content-Type: text/plain; charset="utf-8"
Mime-Version: 1.0 (Mac OS X Mail 16.0 \(3731.500.231\))
Subject: Re: Yangdoctors last call review of draft-ietf-rtgwg-yang-rib-extend-17
From: Acee Lindem <acee.ietf@gmail.com>
In-Reply-To: <168318681259.49785.18220095950036916676@ietfa.amsl.com>
Date: Thu, 04 May 2023 10:52:51 -0400
Cc: yang-doctors@ietf.org, draft-ietf-rtgwg-yang-rib-extend.all@ietf.org, last-call@ietf.org, rtgwg@ietf.org
Content-Transfer-Encoding: quoted-printable
Message-Id: <D432F7B4-D810-42EC-AC5D-B2A44416B18D@gmail.com>
References: <168318681259.49785.18220095950036916676@ietfa.amsl.com>
To: Martin Björklund <mbj+ietf@4668.se>
X-Mailer: Apple Mail (2.3731.500.231)
Archived-At: <https://mailarchive.ietf.org/arch/msg/rtgwg/B2e45jpDFzlvH8Pfvy938VjzrRU>
X-BeenThere: rtgwg@ietf.org
X-Mailman-Version: 2.1.39
Precedence: list
List-Id: Routing Area Working Group <rtgwg.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/rtgwg>, <mailto:rtgwg-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/rtgwg/>
List-Post: <mailto:rtgwg@ietf.org>
List-Help: <mailto:rtgwg-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/rtgwg>, <mailto:rtgwg-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 04 May 2023 14:53:05 -0000

Hi Martin, 

Thanks for your review. I’ve addressed your comments in the -18 version. 

Thanks,
Acee

> On May 4, 2023, at 3:53 AM, Martin Björklund via Datatracker <noreply@ietf.org> wrote:
> 
> Reviewer: Martin Björklund
> Review result: Ready
> 
> This is the third YANG doctor review of this document (I have reviewed -17).
> All comments from my previous review have been addressed.
> 
> So, I have only two very minor comments.
> 
> o  The "description" of the YANG module now reads:
> 
>     This document defines a YANG data model which extends
>     the RIBs defined in ietf-routing YANG module with more
>     route attributes.
> 
>   In the module itself, we usually write "This YANG module ...".  So perhaps simply
> 
>     This YANG module extends the RIBs defined in the 'ietf-routing' YANG module
>     with more route attributes.
> 
> o  Use single quotes to refer to schema nodes.
> 
>   The "description" of the leaf "routes" has:
> 
>     "Total routes for protocol in the RIB.";
> 
>   This looks odd, the grammar is not correct.  Then I realized that the word "protocol" refers
>   to the leaf "protocol".  So I suggest:
> 
>      "Total routes for 'protocol' in the RIB.";
> 
>   The same comment applies to some other descriptions as well.
> 
> 
> 
> /martin
> 
> 
>