Re: [netmod] reference statement examples in draft-ietf-netmod-rfc6087bis-18

Kent Watsen <kwatsen@juniper.net> Fri, 23 February 2018 20:44 UTC

Return-Path: <kwatsen@juniper.net>
X-Original-To: netmod@ietfa.amsl.com
Delivered-To: netmod@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 72D6C124235 for <netmod@ietfa.amsl.com>; Fri, 23 Feb 2018 12:44:31 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.701
X-Spam-Level:
X-Spam-Status: No, score=-2.701 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, RCVD_IN_DNSWL_LOW=-0.7, SPF_PASS=-0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=juniper.net
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 dhrO-DRxHIth for <netmod@ietfa.amsl.com>; Fri, 23 Feb 2018 12:44:29 -0800 (PST)
Received: from mx0b-00273201.pphosted.com (mx0b-00273201.pphosted.com [67.231.152.164]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id A41421205F0 for <netmod@ietf.org>; Fri, 23 Feb 2018 12:44:29 -0800 (PST)
Received: from pps.filterd (m0108162.ppops.net [127.0.0.1]) by mx0b-00273201.pphosted.com (8.16.0.22/8.16.0.22) with SMTP id w1NK03OZ028520; Fri, 23 Feb 2018 12:00:30 -0800
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=juniper.net; h=from : to : subject : date : message-id : references : in-reply-to : content-type : content-id : content-transfer-encoding : mime-version; s=PPS1017; bh=mIGs3D1G/T1bQGvaZpnn0DWcyCppgdO0v5Gx18YnOrs=; b=m/GAqMc7tZ0CHMemYYgtJBnhyrPILfWSm54/WhHhq7IjT9eTrSaJntvYf6b1w0F/jQUi XSHRMX4PVqXVn1EuqsCtWyZ+ui1DmwzkmU3E8BvirtCjXUcR69cRriDfU9g07iaXrX8d 25RMn69gu8eWR25QDD7O2zbLKmEr94vtbiyqGINU5OzUNz/EwINWWgRmX5waBdv7gKc2 TVeXQh4I/QhrsRDmp59OlX6OBDlLLFjk4O45t7RLjxYsjosV4OKXpZGayxj8cMhas8pP WEaPCSJg10moWOlG69fJgn75iOKWCM5DmMr9b+qZcGEifaa6m/Y9Ha6kGQW6aprsoDn4 1g==
Received: from nam03-by2-obe.outbound.protection.outlook.com (mail-by2nam03lp0056.outbound.protection.outlook.com [216.32.180.56]) by mx0b-00273201.pphosted.com with ESMTP id 2gasktr00u-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT); Fri, 23 Feb 2018 12:00:29 -0800
Received: from DM5PR05MB3484.namprd05.prod.outlook.com (10.174.240.147) by DM5PR05MB2987.namprd05.prod.outlook.com (10.168.177.7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.527.6; Fri, 23 Feb 2018 19:49:24 +0000
Received: from DM5PR05MB3484.namprd05.prod.outlook.com ([fe80::507:f464:b89a:c64b]) by DM5PR05MB3484.namprd05.prod.outlook.com ([fe80::507:f464:b89a:c64b%3]) with mapi id 15.20.0548.005; Fri, 23 Feb 2018 19:49:24 +0000
From: Kent Watsen <kwatsen@juniper.net>
To: Juergen Schoenwaelder <j.schoenwaelder@jacobs-university.de>, "netmod@ietf.org" <netmod@ietf.org>
Thread-Topic: [netmod] reference statement examples in draft-ietf-netmod-rfc6087bis-18
Thread-Index: AQHTrHpQAqPOMaYjBk2u2kkn68z4LaOyEgeA
Date: Fri, 23 Feb 2018 19:49:23 +0000
Message-ID: <34515A86-1365-46DE-9B49-3E5BEEC44E07@juniper.net>
References: <20180223071204.wio22cwopgajy7hb@elstar.local>
In-Reply-To: <20180223071204.wio22cwopgajy7hb@elstar.local>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach:
X-MS-TNEF-Correlator:
user-agent: Microsoft-MacOutlook/f.20.0.170309
x-originating-ip: [66.129.241.14]
x-ms-publictraffictype: Email
x-microsoft-exchange-diagnostics: 1; DM5PR05MB2987; 6:qFZ0F+/EqIJ5k8ZXm5k8kuW8Z8P080HznLPtuGYDvQZGl+eQwgZd7hXnyQwmZBG22sfqucyDYB/+Z7lYz0Ke8R7lzZL4aQYfMhA9wHTQ9zN+2knJdeEIQq7T6U1ThlRBZCTvykTvtC4CTCiSWvyumRdUWrDseOR1NP1P1zO4wJnSkSEcjHeaFhbdRFcX+QZXjsyt4L4FVg1li5rs4MOovuRKhr2pJ50/bAbvvyLBFGUq0BL89c0GVGnHwF/kLl3ITMz1pr5+1gpp5cY/NDR34RmKJJ26Q6FWBInl7s03JLQTsEKqMabZXMR8MTIaxtif6aiQ8Bx+bYnOAJtlXi+pgiM/cDfH2SuS1zABsYg6qYP/KS9ROwm5y32PujDBMbd8; 5:sZmOtiwFdPXFG68WQa6v4A+L5DZMeP/iOqKCR0I1zdUYDmKF1bFNlhjJDD0xSPvivIFlRZWGrW0w59jjD10YyUulBFdASU3u64V1JwPCUGwh5TvJKLdy8VnlQzLbtqA3O8xq4puhPioY+HFdsNSwBeA40e3UUgRCqxXYW/oYMTc=; 24:Y0T61hQAi7SVEQyfogUJkIPte3qu0xYtX5b7/hrtmphQ9Rzy2aTQ3yFTsfAvUSriqT5X2ZMchm1a6EPA9k9Kp+7Y+E7YwoZDYibSy3KzxwI=; 7:vDAuzYkAdc9/PM7yLEivE7kvX973xeeGoQoxPtACRQAR1GrlqQUnDaiTLQBjCD7AMqqjeMSs/7RW47x5/tXi7XacZkRUFge2J+BtL3seAPqajtf25/3NV5n8EgdOMwyNDX8P9UHZVyeYaMxcAoaTr4eSqUDqMtIQVtYjod2SGGdNOSP31x8fT+ScD2p/oWnU/zIsoZdYRIvoZ+xJ3R+xJ8b5RKU5MZp/7rX/E+iucESQiX1QwRUjZJTnmM+ot1V5
x-ms-exchange-antispam-srfa-diagnostics: SSOS;
x-ms-office365-filtering-ht: Tenant
x-ms-office365-filtering-correlation-id: acec6bda-48c2-478d-9ad6-08d57af68a22
x-microsoft-antispam: UriScan:; BCL:0; PCL:0; RULEID:(7020095)(4652020)(48565401081)(4534165)(4627221)(201703031133081)(201702281549075)(5600026)(4604075)(3008032)(2017052603307)(7153060)(7193020); SRVR:DM5PR05MB2987;
x-ms-traffictypediagnostic: DM5PR05MB2987:
x-microsoft-antispam-prvs: <DM5PR05MB29874E9EF50FEDC0C9D55C73A5CC0@DM5PR05MB2987.namprd05.prod.outlook.com>
x-exchange-antispam-report-test: UriScan:;
x-exchange-antispam-report-cfa-test: BCL:0; PCL:0; RULEID:(8211001083)(6040501)(2401047)(8121501046)(5005006)(3231101)(944501161)(3002001)(10201501046)(93006095)(93001095)(6055026)(6041288)(20161123558120)(20161123562045)(20161123564045)(201703131423095)(201702281528075)(20161123555045)(201703061421075)(201703061406153)(20161123560045)(6072148)(201708071742011); SRVR:DM5PR05MB2987; BCL:0; PCL:0; RULEID:; SRVR:DM5PR05MB2987;
x-forefront-prvs: 0592A9FDE6
x-forefront-antispam-report: SFV:NSPM; SFS:(10019020)(39860400002)(396003)(366004)(39380400002)(346002)(376002)(199004)(189003)(25786009)(305945005)(5660300001)(82746002)(106356001)(7736002)(14454004)(83716003)(3280700002)(6246003)(86362001)(97736004)(6506007)(66066001)(2906002)(59450400001)(102836004)(26005)(186003)(53936002)(36756003)(6512007)(6116002)(6436002)(99286004)(58126008)(110136005)(8936002)(68736007)(316002)(8676002)(81156014)(81166006)(33656002)(229853002)(3846002)(5250100002)(2501003)(2950100002)(478600001)(105586002)(2900100001)(3660700001)(76176011)(6486002); DIR:OUT; SFP:1102; SCL:1; SRVR:DM5PR05MB2987; H:DM5PR05MB3484.namprd05.prod.outlook.com; FPR:; SPF:None; PTR:InfoNoRecords; A:1; MX:1; LANG:en;
received-spf: None (protection.outlook.com: juniper.net does not designate permitted sender hosts)
x-microsoft-antispam-message-info: xYdf696RyyavIOoJlNurvspVYUa2qA8mh9jZqe6raAuhC2+HPS9Yj7XiGxBRgmMeATXjI2HB4a+KjoTP5rJ7LFPensGD3QNCdaNmNkuufysPUhugoH2YOFmSqA92b9AsqT3S83NK+Hru6csljkHdSm/PU6UUv6GrJgE3pFK8wJw=
spamdiagnosticoutput: 1:99
spamdiagnosticmetadata: NSPM
Content-Type: text/plain; charset="utf-8"
Content-ID: <5EFE47E8FB400C43ABC6F416F66C4FD4@namprd05.prod.outlook.com>
Content-Transfer-Encoding: base64
MIME-Version: 1.0
X-OriginatorOrg: juniper.net
X-MS-Exchange-CrossTenant-Network-Message-Id: acec6bda-48c2-478d-9ad6-08d57af68a22
X-MS-Exchange-CrossTenant-originalarrivaltime: 23 Feb 2018 19:49:24.0060 (UTC)
X-MS-Exchange-CrossTenant-fromentityheader: Hosted
X-MS-Exchange-CrossTenant-id: bea78b3c-4cdb-4130-854a-1d193232e5f4
X-MS-Exchange-Transport-CrossTenantHeadersStamped: DM5PR05MB2987
X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10432:, , definitions=2018-02-23_07:, , signatures=0
X-Proofpoint-Spam-Details: rule=outbound_spam_notspam policy=outbound_spam score=0 priorityscore=1501 malwarescore=0 suspectscore=0 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=789 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1711220000 definitions=main-1802230244
Archived-At: <https://mailarchive.ietf.org/arch/msg/netmod/6KwQmQKz9naOG4b5Ujp1sCsaOmk>
Subject: Re: [netmod] reference statement examples in draft-ietf-netmod-rfc6087bis-18
X-BeenThere: netmod@ietf.org
X-Mailman-Version: 2.1.22
Precedence: list
List-Id: NETMOD WG list <netmod.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/netmod>, <mailto:netmod-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/netmod/>
List-Post: <mailto:netmod@ietf.org>
List-Help: <mailto:netmod-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/netmod>, <mailto:netmod-request@ietf.org?subject=subscribe>
X-List-Received-Date: Fri, 23 Feb 2018 20:44:31 -0000

Juergen writes:
> I think it was common practice to write
>
>   reference "RFC 6991: Common YANG Data Types";
>
> instead of just
>
>   reference "RFC 6991";

Agreed, I always do.


> that is to include the RFC title (this can be especially useful with
> longer lists of references and less commonly known RFC numbers). It
> seems that draft-ietf-netmod-rfc6087bis-18 kind of suggests to only
> use the RFC number (section 3.2 and section 4.7).

If you're suggesting modifying the examples in rfc6087bis, as a 
contributor, I support.

As shepherd, it would be good to hear more support for this change
before formalizing a request.


Kent