Re: New Version Notification for draft-leiba-rfc2119-update-00.txt
Joe Touch <touch@isi.edu> Sat, 13 August 2016 00:48 UTC
Return-Path: <touch@isi.edu>
X-Original-To: ietf@ietfa.amsl.com
Delivered-To: ietf@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 5BE1712D92F for <ietf@ietfa.amsl.com>; Fri, 12 Aug 2016 17:48:24 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -8.166
X-Spam-Level:
X-Spam-Status: No, score=-8.166 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_HI=-5, RCVD_IN_MSPIKE_H3=-0.01, RCVD_IN_MSPIKE_WL=-0.01, RP_MATCHES_RCVD=-1.247] 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 2vQoaPCbZwIJ for <ietf@ietfa.amsl.com>; Fri, 12 Aug 2016 17:48:22 -0700 (PDT)
Received: from boreas.isi.edu (boreas.isi.edu [128.9.160.161]) (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 E07AD12D51B for <ietf@ietf.org>; Fri, 12 Aug 2016 17:48:22 -0700 (PDT)
Received: from [128.9.184.139] ([128.9.184.139]) (authenticated bits=0) by boreas.isi.edu (8.13.8/8.13.8) with ESMTP id u7D0lk8w013681 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NOT); Fri, 12 Aug 2016 17:47:46 -0700 (PDT)
Subject: Re: New Version Notification for draft-leiba-rfc2119-update-00.txt
To: Pete Resnick <presnick@qti.qualcomm.com>
References: <147077254472.30640.13738163813175851232.idtracker@ietfa.amsl.com> <CALaySJLHx7ytgZqZ9zQXA3vVSU-pNggQQs+QiDnzQ4tBEH5VAQ@mail.gmail.com> <B31EEDDDB8ED7E4A93FDF12A4EECD30D9240CC47@GLKXM0002V.GREENLNK.net> <f30c2fb9-2f84-4ff1-8bd2-f70fe4201838@gmail.com> <379B29D6-2C56-4EB1-BA50-4740A605C9D0@qti.qualcomm.com> <6433bb28-3e68-a18b-6bec-6017701baa03@isi.edu> <5A419C3F-E7C7-47E8-B1D6-ED5F09AFED89@qti.qualcomm.com>
From: Joe Touch <touch@isi.edu>
Message-ID: <8c347f14-68a4-b96c-5879-be80dfdae67a@isi.edu>
Date: Fri, 12 Aug 2016 17:47:44 -0700
User-Agent: Mozilla/5.0 (Windows NT 10.0; WOW64; rv:45.0) Gecko/20100101 Thunderbird/45.2.0
MIME-Version: 1.0
In-Reply-To: <5A419C3F-E7C7-47E8-B1D6-ED5F09AFED89@qti.qualcomm.com>
Content-Type: multipart/alternative; boundary="------------BC1679BBBBFF40269FBF4820"
X-ISI-4-43-8-MailScanner: Found to be clean
X-MailScanner-From: touch@isi.edu
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf/c7V-dYePWOOELhExCgKQcvIyy4s>
Cc: Barry Leiba <barryleiba@computer.org>, IETF discussion list <ietf@ietf.org>
X-BeenThere: ietf@ietf.org
X-Mailman-Version: 2.1.17
Precedence: list
List-Id: IETF-Discussion <ietf.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf>, <mailto:ietf-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/ietf/>
List-Post: <mailto:ietf@ietf.org>
List-Help: <mailto:ietf-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf>, <mailto:ietf-request@ietf.org?subject=subscribe>
X-List-Received-Date: Sat, 13 Aug 2016 00:48:24 -0000
FWIW, I was being glib in trying to toss out MUST/MAY/SHOULD (I should have used a smiley :-)). Both adverbs and adjectives are need because protocols include both actions and state: Adverbs indicate constraints on action (of the protocol, implementer, or operator). Adjectives indicate constraints on state. It's equally awkward to use either one for both types of constraints, IMO. Joe On 8/12/2016 5:20 PM, Pete Resnick wrote: > > On 12 Aug 2016, at 19:04, Joe Touch wrote: > > It's inefficient to repeat the phrase "X MUST be supported by any > implementation that complies with this specification". > > Perfect example. That passive construction is just as bad as "X is > REQUIRED". That's a compliance statement, not an interoperability > statement as required by 2119. When "X" is a feature (not a protocol > operation) what does "X MUST be supported" even mean? Why MUST it be > supported? What interoperability problem does it cause if I choose to > do otherwise? 99 times out of 100, when I've see "X is REQUIRED" or "X > MUST be supported", it's a completely bogus use. > > The phrase "X is REQUIRED", RECOMMENDED, or OPTIONAL corresponds > to the > incorrect English of "X is a MUST". > > And I would say don't use any of them. ("X is a MUST" is an abomination.) > > I.e., these are reasonable adjective forms of the adverbs > MUST/MAY/SHOULD. Omitting these adjectives then requires authors to > select their own adjective forms or to have to rewrite everything > as an > adverb. > > Rewriting things to use an adverb is good because it requires you to > have a verb. If the verbs are "support" or "comply", it's a pretty > good sign that you're making the spec less clear. > > IMO, if you want to drop anything, drop the MUST/MAY/SHOULD - > directives > of protocol specs should describe the spec, not the actions of the > implementer. > > Violent agreement on that one. > > pr > > On 8/12/2016 4:13 PM, Pete Resnick wrote: > > On 11 Aug 2016, at 6:44, Stewart Bryant wrote: > > |Optional is useful in a requirements RFC. Feature x is > REQUIRED Feature y is OPTIONAL | > > One last (and perhaps fruitless) attempt to keep this section and > deprecate the adjectives: > > Using REQUIRED and OPTIONAL results in exactly the problem of > using > passive voice anywhere: REQUIRED by whom? OPTIONAL for whom? > If you > say, "A MUST do X and B MAY do Y", it is perfectly clear which > actor > is responsible (and in network protocols there are inevitably > at least > 2). If you say "X is REQUIRED and Y is OPTIONAL", you'll end up > needing more text to explain the actors and their roles. > > Using REQUIRED and OPTIONAL is lazy. It makes specs less > clear. They > ought to be dropped. > > pr > > -- > Pete Resnick http://www.qualcomm.com/~presnick/ > <http://www.qualcomm.com/%7Epresnick/> > Qualcomm Technologies, Inc. - +1 (858)651-4478 >
- Re: New Version Notification for draft-leiba-rfc2… John C Klensin
- Re: New Version Notification for draft-leiba-rfc2… John R Levine
- Re: New Version Notification for draft-leiba-rfc2… Dave Crocker
- Re: New Version Notification for draft-leiba-rfc2… John Levine
- Re: New Version Notification for draft-leiba-rfc2… Randall Gellens (IETF)
- Re: New Version Notification for draft-leiba-rfc2… Joe Touch
- Re: New Version Notification for draft-leiba-rfc2… Gmail
- Re: New Version Notification for draft-leiba-rfc2… Brian E Carpenter
- Re: New Version Notification for draft-leiba-rfc2… John C Klensin
- Re: New Version Notification for draft-leiba-rfc2… Dave Crocker
- Re: New Version Notification for draft-leiba-rfc2… Pete Resnick
- Re: New Version Notification for draft-leiba-rfc2… Joe Touch
- Re: New Version Notification for draft-leiba-rfc2… Dave Crocker
- Re: New Version Notification for draft-leiba-rfc2… Pete Resnick
- Re: New Version Notification for draft-leiba-rfc2… Julian Reschke
- Re: New Version Notification for draft-leiba-rfc2… Michael Richardson
- Re: New Version Notification for draft-leiba-rfc2… Julian Reschke
- Re: New Version Notification for draft-leiba-rfc2… Ted Lemon
- Re: New Version Notification for draft-leiba-rfc2… Ben Campbell
- Re: New Version Notification for draft-leiba-rfc2… HANSEN, TONY L
- RE: New Version Notification for draft-leiba-rfc2… John C Klensin
- Re: New Version Notification for draft-leiba-rfc2… Barry Leiba
- RE: New Version Notification for draft-leiba-rfc2… Dearlove, Christopher (UK)
- Re: New Version Notification for draft-leiba-rfc2… Ted Lemon
- Re: New Version Notification for draft-leiba-rfc2… Stewart Bryant
- RE: New Version Notification for draft-leiba-rfc2… Dearlove, Christopher (UK)
- Re: New Version Notification for draft-leiba-rfc2… John C Klensin
- Re: New Version Notification for draft-leiba-rfc2… John C Klensin
- Re: New Version Notification for draft-leiba-rfc2… Dave Crocker
- Re: New Version Notification for draft-leiba-rfc2… John C Klensin
- Re: New Version Notification for draft-leiba-rfc2… Michael Richardson
- Re: New Version Notification for draft-leiba-rfc2… Barry Leiba
- Re: New Version Notification for draft-leiba-rfc2… Doug Ewell
- Re: New Version Notification for draft-leiba-rfc2… Dave Cridland
- Re: New Version Notification for draft-leiba-rfc2… Barry Leiba
- Re: New Version Notification for draft-leiba-rfc2… Time Warner Cable
- Re: New Version Notification for draft-leiba-rfc2… Michael Richardson
- Re: New Version Notification for draft-leiba-rfc2… Barry Leiba
- Re: New Version Notification for draft-leiba-rfc2… Michael Richardson
- Re: New Version Notification for draft-leiba-rfc2… Ted Lemon
- Re: New Version Notification for draft-leiba-rfc2… Ted Lemon
- Re: New Version Notification for draft-leiba-rfc2… John Leslie
- Re: New Version Notification for draft-leiba-rfc2… Ted Lemon
- Re: New Version Notification for draft-leiba-rfc2… Stewart Bryant
- Re: New Version Notification for draft-leiba-rfc2… Stewart Bryant
- Re: New Version Notification for draft-leiba-rfc2… Stewart Bryant
- Re: New Version Notification for draft-leiba-rfc2… Stewart Bryant
- Re: New Version Notification for draft-leiba-rfc2… Randy Bush
- Re: New Version Notification for draft-leiba-rfc2… Dave Crocker
- Re: New Version Notification for draft-leiba-rfc2… Michael Richardson
- Re: New Version Notification for draft-leiba-rfc2… Mark Andrews
- Re: New Version Notification for draft-leiba-rfc2… John R Levine
- Re: New Version Notification for draft-leiba-rfc2… Mark Andrews
- Re: New Version Notification for draft-leiba-rfc2… John Levine
- Re: New Version Notification for draft-leiba-rfc2… Scott O. Bradner
- Re: New Version Notification for draft-leiba-rfc2… Joe Touch
- Re: New Version Notification for draft-leiba-rfc2… Sam Hartman
- Re: New Version Notification for draft-leiba-rfc2… Dave Crocker
- Re: New Version Notification for draft-leiba-rfc2… Sam Hartman
- Re: New Version Notification for draft-leiba-rfc2… Barry Leiba
- Re: New Version Notification for draft-leiba-rfc2… Stephan Wenger
- Re: New Version Notification for draft-leiba-rfc2… Barry Leiba
- Re: New Version Notification for draft-leiba-rfc2… Ted Hardie
- Re: New Version Notification for draft-leiba-rfc2… Paul Hoffman