Skip to main content

Shepherd writeup
draft-ietf-dhc-option-guidelines

Write up for draft-ietf-dhc-option-guidelines-13.txt
----------------------------------------------------

(1) What type of RFC is being requested (BCP, Proposed Standard, 
    Internet Standard, Informational, Experimental, or Historic)? Why 
    is this the proper type of RFC? Is this type of RFC indicated in 
    the title page header? 

BCP.  This documents how DHCPv6 options should be formatted.

(2) The IESG approval announcement includes a Document Announcement 
    Write-Up. Please provide such a Document Announcement 
    Write-Up. Recent examples can be found in the "Action" 
    announcements for approved documents. The approval announcement 
    contains the following sections: 

Technical Summary: 

This document provides guidance to prospective DHCPv6 developers to
help them create new options that are easily adoptable by existing
DHCPv6 software. 

Working Group Summary: 

This document has been in development in the DHC working group for a
long time. It started out targetted for DHCPv4 but was reworked for
DHCPv6 as the working group expects more options to be defined for
DHCPv6 going fowrard. There has been solid support for this work.

Document Quality: 

The document has had extensive review and input by the working group
and "DHCP experts".


Personnel: 

Bernie Volz is the document shepherd. Ted Lemon is the responsible AD. 

(3) Briefly describe the review of this document that was performed by 
    the Document Shepherd. If this version of the document is not 
    ready for publication, please explain why the document is being 
    forwarded to the IESG. 

I read the document thoroughly, and submitted quite a few editorial 
suggestions to the authors, which they implemented. 

(4) Does the document Shepherd have any concerns about the depth or 
    breadth of the reviews that have been performed? 

No, the document has had a great deal of careful review.

(5) Do portions of the document need review from a particular or from 
    broader perspective, e.g., security, operational complexity, AAA, 
    DNS, DHCP, XML, or internationalization? If so, describe the 
    review that took place. 

This is strictly a DHCP doc, and has had plenty of review from DHCP
experts. 

(6) Describe any specific concerns or issues that the Document 
    Shepherd has with this document that the Responsible Area Director 
    and/or the IESG should be aware of? For example, perhaps he or she 
    is uncomfortable with certain parts of the document, or has 
    concerns whether there really is a need for it. In any event, if 
    the WG has discussed those issues and has indicated that it still 
    wishes to advance the document, detail those concerns here. 

I think the document is good as written, and serves an extremely
useful purpose. It will assist other working groups and individuals
in developing new DHCP options.


(7) Has each author confirmed that any and all appropriate IPR 
    disclosures required for full conformance with the provisions of 
    BCP 78 and BCP 79 have already been filed. If not, explain why? 

Yes - the authors confirmed that there are no IPR disclosures required.

(8) Has an IPR disclosure been filed that references this document? If 
    so, summarize any WG discussion and conclusion regarding the IPR 
    disclosures. 

No.

(9) How solid is the WG consensus behind this document? Does it 
    represent the strong concurrence of a few individuals, with others 
    being silent, or does the WG as a whole understand and agree with it? 

There is a very strong consensus behind this document and in particular
from very active WG participants (i.e. "DHCP experts").

(10) Has anyone threatened an appeal or otherwise indicated extreme 
    discontent? If so, please summarise the areas of conflict in 
    separate email messages to the Responsible Area Director. (It 
    should be in a separate email because this questionnaire is 
    publicly available.) 

No, and nobody's indicated that they were against the WGLC or had
any issues with the document. It document existing, but undocumented,
practices.

(11) Identify any ID nits the Document Shepherd has found in this 
    document. (See http://www.ietf.org/tools/idnits/ and the 
    Internet-Drafts Checklist). Boilerplate checks are not enough; 
    this check needs to be thorough. 

The document passes idnits with no errors and review using the
checklist did not turn up any issues. It does raise an issue with
regards to content prior to Nov 2008, but the one author of the
document (David Hankins) prior to this date has no issues with
granting the BCP78 rights to the IETF Trust.


(12) Describe how the document meets any required formal review 
    criteria, such as the MIB Doctor, media type, and URI type 
    reviews. 

The document contains nothing like this. 

(13) Have all references within this document been identified as 
    either normative or informative? 

Yes. 

(14) Are there normative references to documents that are not ready 
    for advancement or are otherwise in an unclear state? If such 
    normative references exist, what is the plan for their 
    completion? 

No, all the normative references are to RFCs. 

(15) Are there downward normative references references (see RFC 
    3967)? If so, list these downward references to support the Area 
    Director in the Last Call procedure. 

No. 

(16) Will publication of this document change the status of any 
    existing RFCs? Are those RFCs listed on the title page header, 
    listed in the abstract, and discussed in the introduction? If the 
    RFCs are not listed in the Abstract and Introduction, explain 
    why, and point to the part of the document where the relationship 
    of this document to the other RFCs is discussed. If this 
    information is not in the document, explain why the WG considers 
    it unnecessary. 

Not that status, but it does update RFC 3315. I have a small concern
here as this updates to RFC 3315 are not clearly spelled out - they are
in Section 16 (options are singletons unless specified otherwise) and
17 (options have no ordering). These are more clarifications of RFC
3315 as that document did not explicitly address these issues.


(17) Describe the Document Shepherd's review of the IANA 
    considerations section, especially with regard to its consistency 
    with the body of the document. Confirm that all protocol 
    extensions that the document makes are associated with the 
    appropriate reservations in IANA registries. Confirm that any 
    referenced IANA registries have been clearly identified. Confirm 
    that newly created IANA registries include a detailed 
    specification of the initial contents for the registry, that 
    allocations procedures for future registrations are defined, and 
    a reasonable name for the new registry has been suggested (see 
    RFC 5226). 

I reviewed the IANA Considerations section and it is fine and clear,
there are no IANA actions.

(18) List any new IANA registries that require Expert Review for 
    future allocations. Provide any public guidance that the IESG 
    would find useful in selecting the IANA Experts for these new 
    registries. 

None. 

(19) Describe reviews and automated checks performed by the Document 
    Shepherd to validate sections of the document written in a formal 
    language, such as XML code, BNF rules, MIB definitions, etc. 

There are no such parts to the document.

Back