On Fri, Jun 23, 2017 at 1:28 PM, Lou Berger <[email protected]> wrote:
> I happened to be looking at Appendix C. YANG Module Template (because a > YANG Dr pointed out that I wasn't following it in one of my drafts) and > noticed an inconsistency. The template says: > Copyright (c) <insert year> IETF Trust and the persons > identified as authors of the code. All rights reserved. > > Which matches current trust language, so this is all good. > > But: the template then has > Editor: your-name > <mailto:[email protected]>"; > > *and* no place to list all who authored the "code", i.e., the module. > Given the copyright, I think the template should be revised to: > > OLD > Editor: your-name > <mailto:[email protected]>"; > NEW > Authors: //List all who contributed text to the module > your-name > <mailto:[email protected]>"; > > How about just "Authors". It is an administrative nightmare to keep track of everyone who contributed the tiniest edit to a module. The module header would be 10 pages long listing the name and email of anyone who contributed any text. The draft itself has a contributors section. The template has always been to list the document authors here. > Lou > Andy > > On 6/19/2017 12:54 AM, [email protected] wrote: > > A New Internet-Draft is available from the on-line Internet-Drafts > directories. > > This draft is a work item of the NETCONF Data Modeling Language of the > IETF. > > > > Title : Guidelines for Authors and Reviewers of YANG > Data Model Documents > > Author : Andy Bierman > > Filename : draft-ietf-netmod-rfc6087bis-13.txt > > Pages : 64 > > Date : 2017-06-18 > > > > Abstract: > > This memo provides guidelines for authors and reviewers of Standards > > Track specifications containing YANG data model modules. Applicable > > portions may be used as a basis for reviews of other YANG data model > > documents. Recommendations and procedures are defined, which are > > intended to increase interoperability and usability of Network > > Configuration Protocol (NETCONF) and RESTCONF protocol > > implementations that utilize YANG data model modules. This document > > obsoletes RFC 6087. > > > > > > The IETF datatracker status page for this draft is: > > https://datatracker.ietf.org/doc/draft-ietf-netmod-rfc6087bis/ > > > > There are also htmlized versions available at: > > https://tools.ietf.org/html/draft-ietf-netmod-rfc6087bis-13 > > https://datatracker.ietf.org/doc/html/draft-ietf-netmod-rfc6087bis-13 > > > > A diff from the previous version is available at: > > https://www.ietf.org/rfcdiff?url2=draft-ietf-netmod-rfc6087bis-13 > > > > > > Please note that it may take a couple of minutes from the time of > submission > > until the htmlized version and diff are available at tools.ietf.org. > > > > Internet-Drafts are also available by anonymous FTP at: > > ftp://ftp.ietf.org/internet-drafts/ > > > > _______________________________________________ > > netmod mailing list > > [email protected] > > https://www.ietf.org/mailman/listinfo/netmod > > > >
_______________________________________________ netmod mailing list [email protected] https://www.ietf.org/mailman/listinfo/netmod
