Re: [yang-doctors] Normative Language in YANG descriptions

Mahesh Jethanandani <mjethanandani@gmail.com> Thu, 17 September 2020 05:05 UTC

Return-Path: <mjethanandani@gmail.com>
X-Original-To: yang-doctors@ietfa.amsl.com
Delivered-To: yang-doctors@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id DB9033A0A79 for <yang-doctors@ietfa.amsl.com>; Wed, 16 Sep 2020 22:05:18 -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, HTML_MESSAGE=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=unavailable autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=gmail.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 RYcBMGr47hDO for <yang-doctors@ietfa.amsl.com>; Wed, 16 Sep 2020 22:05:16 -0700 (PDT)
Received: from mail-pf1-x433.google.com (mail-pf1-x433.google.com [IPv6:2607:f8b0:4864:20::433]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 2842D3A0A66 for <yang-doctors@ietf.org>; Wed, 16 Sep 2020 22:05:16 -0700 (PDT)
Received: by mail-pf1-x433.google.com with SMTP id f18so446036pfa.10 for <yang-doctors@ietf.org>; Wed, 16 Sep 2020 22:05:16 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:message-id:mime-version:subject:date:in-reply-to:cc:to :references; bh=Q5M59T/on5gdhmZ0w0H0+nXmzKPj34w2ZaW4604a2Rs=; b=EVNYsEiPeNDgZg1OxVxs6gQCpvnPsS1H2zLRuAcc0RsGuqDG52Pf4uACyOYSIIKU3c S2U8BVjHiWAqcZd5SfzaAB8mML/LCtl8x2ixlnphKPoNtHqNeGXOg4juvHqLwbDQqEgH f1dflmjmFekZkTQtmJg2gQD6PnEFavOILFlhsmhmlRRuTIBBMSeCa38joXJMln82hl0e n1DE9AtXCcFw+E3n0AVTL4mLyPxY4OrAOK4oL0/QBedSU+GKqQIr/0QEDoEfY/ttdU++ 7svlpr3GOZlUSJG18Xjtf2tazKtp0++0uD8+7Hl7a5gp6mrFpwvIbbUk3+UzEt31zihx 3fOw==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:message-id:mime-version:subject:date :in-reply-to:cc:to:references; bh=Q5M59T/on5gdhmZ0w0H0+nXmzKPj34w2ZaW4604a2Rs=; b=ulYsxpDITHB+S/7EjUfFPZMqvPsjUHqBLessh3wovY+y5X/axPh/7qIwb6rbC3CYxj ZQUS5iPzBuMU8jcOQvpPVADygiMrKY5BJPdV73885WSMFYCdhh7X8kHkreuRRj+rRKDV mlbYxPDgH4p1RyVtimXyzu2VAS3+yzlqCwmelH9tFAwEuFb2JDnAIL2iTH2g/SxIj6Ye yF67MMrb+p5ZJxnsv+a7IqpTDj///mw/3yzG1Zq57/jUsCePhS8y/N0ejemTnD668S+l V0x5TSK3MehcHVauG1/H523JQQmcmvzm4NytGOcEmdqpEaS7Kb1GQ0drOnEU0fPO/xw4 p8xw==
X-Gm-Message-State: AOAM532nuXWEe2uerf5+7U65UMKoWOoKvtK4qqQo3LWU9Zzbx1tDUlOJ oVazjxiBmkaHa65qHInU+8Y=
X-Google-Smtp-Source: ABdhPJwRllqUIo8QQriSvRjeD2KtzAIAXbqFk/rk2HpPdfInqMoowEKsHVXtVu0qK3P2bJGlvZ5Kuw==
X-Received: by 2002:a62:c701:0:b029:142:2501:34e9 with SMTP id w1-20020a62c7010000b0290142250134e9mr9484258pfg.66.1600319115133; Wed, 16 Sep 2020 22:05:15 -0700 (PDT)
Received: from [192.168.1.116] (c-73-93-49-153.hsd1.ca.comcast.net. [73.93.49.153]) by smtp.gmail.com with ESMTPSA id bx22sm4416776pjb.23.2020.09.16.22.05.14 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 16 Sep 2020 22:05:14 -0700 (PDT)
From: Mahesh Jethanandani <mjethanandani@gmail.com>
Message-Id: <A139C0F3-A398-4F22-8658-822312AFF043@gmail.com>
Content-Type: multipart/alternative; boundary="Apple-Mail=_9EFE998B-B275-4DFA-BD3E-EBC8E752A400"
Mime-Version: 1.0 (Mac OS X Mail 11.5 \(3445.9.6\))
Date: Wed, 16 Sep 2020 22:05:13 -0700
In-Reply-To: <AE8C544D-75B1-44C5-878F-A6B809B8CC2D@cisco.com>
Cc: YANG Doctors <yang-doctors@ietf.org>
To: "Acee Lindem (acee)" <acee=40cisco.com@dmarc.ietf.org>
References: <AE8C544D-75B1-44C5-878F-A6B809B8CC2D@cisco.com>
X-Mailer: Apple Mail (2.3445.9.6)
Archived-At: <https://mailarchive.ietf.org/arch/msg/yang-doctors/jmY4442fUYSHZLRPet3YWFaMQdw>
Subject: Re: [yang-doctors] Normative Language in YANG descriptions
X-BeenThere: yang-doctors@ietf.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Email list of the yang-doctors directorate <yang-doctors.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/yang-doctors>, <mailto:yang-doctors-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/yang-doctors/>
List-Post: <mailto:yang-doctors@ietf.org>
List-Help: <mailto:yang-doctors-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/yang-doctors>, <mailto:yang-doctors-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 17 Sep 2020 05:05:19 -0000

+1.

> On Sep 16, 2020, at 4:53 AM, Acee Lindem (acee) <acee=40cisco.com@dmarc.ietf.org> wrote:
> 
> All, 
>  
> I just received a comment on validation in a description statement for ietf-routing-policy. The comment was more of a question as whether “should” should be “SHOULD”. I looked at our existing published models and we have not been doing this consistently. Perhaps we SHOULD when it is normative validation.
>  
> Thanks,
> Acee
> _______________________________________________
> yang-doctors mailing list
> yang-doctors@ietf.org <mailto:yang-doctors@ietf.org>
> https://www.ietf.org/mailman/listinfo/yang-doctors <https://www.ietf.org/mailman/listinfo/yang-doctors>
Mahesh Jethanandani
mjethanandani@gmail.com