Re: [yang-doctors] SHOULD statements in rfc6087bis

Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de> Sat, 26 May 2018 10:59 UTC

Return-Path: <j.schoenwaelder@jacobs-university.de>
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 AFF33124B0A for <yang-doctors@ietfa.amsl.com>; Sat, 26 May 2018 03:59:44 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -1.899
X-Spam-Level:
X-Spam-Status: No, score=-1.899 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, 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 QKVJD2u6emPm for <yang-doctors@ietfa.amsl.com>; Sat, 26 May 2018 03:59:42 -0700 (PDT)
Received: from anna.localdomain (firewallix.jacobs-university.de [212.201.44.247]) by ietfa.amsl.com (Postfix) with ESMTP id 55513120047 for <yang-doctors@ietf.org>; Sat, 26 May 2018 03:59:42 -0700 (PDT)
Received: by anna.localdomain (Postfix, from userid 501) id 043BF21827A1; Sat, 26 May 2018 12:59:40 +0200 (CEST)
Date: Sat, 26 May 2018 12:59:40 +0200
From: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
To: Martin Bjorklund <mbj@tail-f.com>
Cc: kwatsen@juniper.net, ibagdona@gmail.com, yang-doctors@ietf.org
Message-ID: <20180526105940.aibhyqar7jfqsjhd@anna.jacobs.jacobs-university.de>
Reply-To: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>
Mail-Followup-To: Martin Bjorklund <mbj@tail-f.com>, kwatsen@juniper.net, ibagdona@gmail.com, yang-doctors@ietf.org
References: <a65d44c5-86c9-bf05-4ce5-0e0cb44943e5@cisco.com> <C613B3EE-5A22-4C45-9DD4-293EC5B2837D@cisco.com> <704131DB-D473-44B9-A39F-241AE12CECD3@juniper.net> <20180526.121503.1345971315421383207.mbj@tail-f.com>
MIME-Version: 1.0
Content-Type: text/plain; charset="us-ascii"
Content-Disposition: inline
In-Reply-To: <20180526.121503.1345971315421383207.mbj@tail-f.com>
User-Agent: NeoMutt/20180512
Archived-At: <https://mailarchive.ietf.org/arch/msg/yang-doctors/5b5PI9cVbUrKoseTGQUxcAaZ_Dg>
Subject: Re: [yang-doctors] SHOULD statements in rfc6087bis
X-BeenThere: yang-doctors@ietf.org
X-Mailman-Version: 2.1.22
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: Sat, 26 May 2018 10:59:45 -0000

On Sat, May 26, 2018 at 12:15:03PM +0200, Martin Bjorklund wrote:
> 
> The whole point of having a SHOULD instead of MUST is that there are
> cases where the rule/recommendation simply doesn't need to be
> followed.  IMO this is a perfect example of when the description isn't
> needed.  The WG has decided that description for an enum is a SHOULD,
> not a MUST, so why do we not follow this guideline?
>

  (i) Because people want a clean compile.
 (ii) Because people do not want to have to enter a discussion every
      time whether an exception to the SHOULD applies or not.
(iii) Because people do not want to hold off important technical work
      debating weeks whether a non-harmful redundant description should
      be added or not.

And at the end of the day, if the SHOULD forces some redundant
descriptions, then this is likely less harmful than missing
descriptions and overall the SHOULD does its job even if it is
interpreted effectively as a MUST unless you have lots of time and
energy for a lengthy debate.

/js

PS: Have you never made changes to C code to get a clean compile even
    if the change was not strictly needed?

-- 
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/>