draft-ietf-genarea-datatracker-iana-rfced-extns-04.txt   rfc6359.txt 
Internet Engineering Task Force (IETF) S. Ginoza Internet Engineering Task Force (IETF) S. Ginoza
Internet-Draft AMS Request for Comments: 6359 AMS
Intended Status: Informational M. Cotton Category: Informational M. Cotton
Expires: December 20, 2011 ICANN ISSN: 2070-1721 ICANN
A. Morris A. Morris
AMS AMS
June 20, 2011 September 2011
Datatracker Extensions to Datatracker Extensions to
Include IANA and RFC Editor Processing Information Include IANA and RFC Editor Processing Information
<draft-ietf-genarea-datatracker-iana-rfced-extns-04.txt>
Abstract Abstract
This document captures the requirements for integrating IANA and RFC This document captures the requirements for integrating IANA and RFC
Editor state information into the Datatracker to provide the Editor state information into the Datatracker to provide the
community with a unified tool to track the status of their document community with a unified tool to track the status of their document
as it progresses from Internet-Draft (I-D) version -00 to RFC. as it progresses from Internet-Draft (I-D) version -00 to RFC.
Extending the Datatracker to hold document data from I-D version -00 Extending the Datatracker to hold document data from I-D version -00
to RFC allows for increased automation between the Datatracker, IANA, to RFC allows for increased automation between the Datatracker, IANA,
and RFC Editor, thus reducing manual labor, processing errors, and and RFC Editor, thus reducing manual labor, processing errors, and
potential delay. Therefore, this document also describes the potential delay. Therefore, this document also describes the
requirements to make such automation possible. requirements to make such automation possible.
Status of this Memo Status of This Memo
This Internet-Draft is submitted in full conformance with the This document is not an Internet Standards Track specification; it is
provisions of BCP 78 and BCP 79. published for informational purposes.
Internet-Drafts are working documents of the Internet Engineering This document is a product of the Internet Engineering Task Force
Task Force (IETF). Note that other groups may also distribute (IETF). It represents the consensus of the IETF community. It has
working documents as Internet-Drafts. The list of current Internet- received public review and has been approved for publication by the
Drafts is at http://datatracker.ietf.org/drafts/current/. Internet Engineering Steering Group (IESG). Not all documents
approved by the IESG are a candidate for any level of Internet
Standard; see Section 2 of RFC 5741.
Internet-Drafts are draft documents valid for a maximum of six months Information about the current status of this document, any errata,
and may be updated, replaced, or obsoleted by other documents at any and how to provide feedback on it may be obtained at
time. It is inappropriate to use Internet-Drafts as reference http://www.rfc-editor.org/info/rfc6359.
material or to cite them other than as "work in progress."
Copyright Notice Copyright Notice
Copyright (c) 2011 IETF Trust and the persons identified as the Copyright (c) 2011 IETF Trust and the persons identified as the
document authors. All rights reserved. document authors. All rights reserved.
This document is subject to BCP 78 and the IETF Trust's Legal This document is subject to BCP 78 and the IETF Trust's Legal
Provisions Relating to IETF Documents Provisions Relating to IETF Documents
(http://trustee.ietf.org/license-info) in effect on the date of (http://trustee.ietf.org/license-info) in effect on the date of
publication of this document. Please review these documents publication of this document. Please review these documents
skipping to change at page 2, line 47 skipping to change at page 2, line 47
process [IDTRACKER]. In this document, the term "IETF Datatracker" process [IDTRACKER]. In this document, the term "IETF Datatracker"
is used as a generic name for the existing tool used to track state is used as a generic name for the existing tool used to track state
changes as Internet-Drafts are processed. The word "IETF" in the changes as Internet-Drafts are processed. The word "IETF" in the
name "IETF Datatracker" is not meant to limit use of the tool to the name "IETF Datatracker" is not meant to limit use of the tool to the
IETF document stream; this document expands use of the tool to the IETF document stream; this document expands use of the tool to the
other streams described in [RFC4844]. other streams described in [RFC4844].
The Datatracker is used to report on the status of I-Ds that have The Datatracker is used to report on the status of I-Ds that have
been submitted to the IESG for evaluation and publication. The been submitted to the IESG for evaluation and publication. The
Datatracker will be extended, according to the requirements defined Datatracker will be extended, according to the requirements defined
in [RFC6174] and [ALT-STREAMS], to include tracking information about in [RFC6174] and [RFC6322], to include tracking information about a
a document during its progression from version -00 to it being document during its progression from version -00 to it being
requested for IESG evaluation. However, the Datatracker, ICANN requested for IESG evaluation. However, the Datatracker, ICANN
(performing the IANA function), and RFC Editor operate on separate (performing the IANA function), and RFC Editor operate on separate
systems with varying degrees of visibility into the processing that systems with varying degrees of visibility into the processing that
takes place once the stream managers have approved a document for takes place once the stream managers have approved a document for
publication as an RFC. This document defines the requirements for publication as an RFC. This document defines the requirements for
extending the Datatracker to include increased IANA and RFC Editor extending the Datatracker to include increased IANA and RFC Editor
state information, so that the Datatracker covers the lifetime of an state information, so that the Datatracker covers the lifetime of an
I-D from version -00 to RFC publication. I-D from version -00 to RFC publication.
Additionally, this document lists the processes between the IANA, RFC Additionally, this document lists the processes between the IANA, RFC
Editor, and Secretariat (via the Datatracker) that should be Editor, and Secretariat (via the Datatracker) that should be
automated for accuracy and timely processing. While this document automated for accuracy and timely processing. While this document
includes some details of the IANA, RFC Editor, and Secretariat includes some details of the IANA, RFC Editor, and Secretariat
process, this document does not define any of the processes. The process, this document does not define any of the processes. The
processes are continually reviewed for process optimization and need processes are continually reviewed for process optimization and need
to remain flexible to adapt to new changes in policy and environment. to remain flexible to adapt to new changes in policy and environment.
Processes are defined and set by each of the entities respectively. Processes are defined and set by each of the entities respectively.
The IANA and RFC Editor are functions independent of the IETF. When The IANA and RFC Editor are functions independent of the IETF. When
an Internet-Draft enters the IANA queue, IANA retains ownership of an Internet-Draft enters the IANA queue, IANA retains ownership of
its own data, state names, and tracking systems. Similarly, when an its own data, state names, and tracking systems. Similarly, when an
Internet-Draft enters the RFC Editor's queue, the RFC Editor retains Internet-Draft enters the RFC Editor's queue, the RFC Editor retains
ownership of its own data, state names, and tracking systems. This ownership of its own data, state names, and tracking systems. This
document discusses how the data from the IANA and RFC Editor queues document discusses how the data from the IANA and RFC Editor queues
can be better reflected in the Datatracker to help inform the IETF can be better reflected in the Datatracker to help inform the IETF
community what the state of a document is throughout its lifetime. community what the state of a document is throughout its lifetime.
Prior to when an Internet-Draft is approved for publication as an Prior to when an Internet-Draft is approved for publication as an
RFC, the Datatracker is the definitive source for tracking IANA RFC, the Datatracker is the definitive source for tracking IANA
status information, and the IANA data is editable (by IANA and the status information, and the IANA data is editable (by IANA and the
Secretariat) in the Datatracker. After an Internet-Draft is approved Secretariat) in the Datatracker. After an Internet-Draft is approved
for publication as an RFC, the IANA tracking system becomes the for publication as an RFC, the IANA tracking system becomes the
definitive source for tracking IANA status information, and the data definitive source for tracking IANA status information, and the data
can no longer be edited in the Datatracker. At that point, the data can no longer be edited in the Datatracker. At that point, the data
in the Datatracker is only a reflection of the data in the IANA in the Datatracker is only a reflection of the data in the IANA
tracking system. If there is a discrepancy at between the two after tracking system. If there is a discrepancy between the two after
this point, the data in the IANA tracking system is assumed to be this point, the data in the IANA tracking system is assumed to be
correct. correct.
The RFC Editor's tracking system is always the definitive source for The RFC Editor's tracking system is always the definitive source for
tracking RFC Editor status of a document. RFC Editor data is not tracking the RFC Editor status of a document. RFC Editor data is not
editable via the Datatracker. The information in the Datatracker is editable via the Datatracker. The information in the Datatracker is
always a reflection of the information in the RFC Editor's tracking always a reflection of the information in the RFC Editor's tracking
system. system.
2. Integration of Data between the IANA and Datatracker 2. Integration of Data between the IANA and Datatracker
2.1. IANA Information To Be Added to the Datatracker 2.1. IANA Information to Be Added to the Datatracker
Currently, IANA reviews and touches documents at 4 different stages Currently, IANA reviews and touches IETF stream documents at 4
in the process from I-D to RFC for IETF stream documents: IETF Last different stages in the process from I-D to RFC: IETF Last Call, IESG
Call, IESG Review, Document Approval (for publication), and RFC Review, Document Approval (for publication), and RFC Publication.
Publication. Most of these state changes and issues are not captured
in the Datatracker. For the IRTF and INDEPENDENT streams, the IANA Most of these state changes and issues are not captured in the
review process begins when IESG Review is requested. For the IAB Datatracker. For the IRTF (Internet Research Task Force) and
stream, review would begin upon request for publication as an RFC. Independent streams, the IANA review process begins when IESG Review
is requested. For the IAB (Internet Architecture Board) stream,
review would begin upon request for publication as an RFC.
This section specifies the requirements for including additional IANA This section specifies the requirements for including additional IANA
information in the Datatracker. information in the Datatracker.
- IETF Last Call Comments - IETF Last Call Comments
Currently, IANA reviews I-Ds that have been sent to IETF Last Currently, IANA reviews I-Ds that have been sent to IETF Last
Call, inputs comments in their data system, and then emails their Call, inputs comments in their data system, and then emails their
comments to authors, WG chairs, and then to the IESG. These comments to authors, WG chairs, and then to the IESG. These
comments are also manually entered into the Datatracker for the comments are also manually entered into the Datatracker for the
public record. However, it is difficult to determine whether the public record. However, it is difficult to determine whether the
IANA issues have been resolved. To help facilitate tracking of IANA issues have been resolved. To help facilitate tracking of
IANA issues, a display is needed to show 5 new IANA substates, in IANA issues, a display is needed to show 5 new IANA substates, in
a similar fashion to how RFC Editor State is currently shown in a similar fashion to how RFC Editor State is currently shown in
the Datatracker (see example of how IANA state information could the Datatracker (see the example, later in this section, of how
appear in the Datatracker for draft-example-00 below). IANA state information could appear in the Datatracker for
draft-example-00).
1) IANA Review Needed 1) IANA Review Needed
This substate will allow the community, Secretariat, and IANA This substate will allow the community, Secretariat, and IANA
to easily track which documents have or have not been reviewed to easily track which documents have or have not been reviewed
by IANA. If this substate is NOT set to IANA Not OK or IANA by IANA. If this substate is NOT set to "IANA Not OK", "IANA
OK, the substate should be set to "IANA review needed" by OK -- Actions Needed", or "IANA OK -- No Actions Needed", the
default (this is the first substate for tracking IANA data). substate should be set to "IANA Review Needed" by default (this
For documents that originate from a non-IETF stream, the is the first substate for tracking IANA data). For documents
default will be used. that originate from a non-IETF stream, the default will be
used.
2) IANA OK -- Actions Needed 2) IANA OK -- Actions Needed
This substate covers documents that require IANA actions and This substate covers documents that require IANA actions, and
the IANA considerations section indicates the details of the the IANA Considerations section indicates the details of the
actions correctly. actions correctly.
3) IANA OK -- No Actions Needed 3) IANA OK -- No Actions Needed
This substate covers documents that require no IANA actions and This substate covers documents that require no IANA actions,
the IANA considerations section indicates this correctly. and the IANA Considerations section indicates this correctly.
NOTE: The substate will be set to "IANA OK -- Action Needed" or Note: The substate will be set to "IANA OK -- Action Needed" or
"IANA OK -- No Actions Needed" (from "IANA Not OK") once any "IANA OK -- No Actions Needed" (from "IANA Not OK") once any
outstanding issues have been resolved. The comments section will outstanding issues have been resolved. The comments section will
be used to provide details in the History log about whether there be used to provide details in the History log about whether there
are no IANA actions, the text is OK, or the issues have been are no IANA actions, the text is OK, or the issues have been
resolved. resolved.
4) IANA Not OK 4) IANA Not OK
If IANA has issues with the text of the IANA Considerations If IANA has issues with the text of the IANA Considerations
section of a document, the substate should be set to "IANA Not section of a document, the substate should be set to "IANA Not
OK" and the comment field should be populated with a OK", and the comment field should be populated with a
description of the issues and questions. In addition to any description of the issues and questions. In addition to any
questions IANA may have, IANA will also include in the comments questions IANA may have, IANA will also include in the comments
field whether expert review is required, if the doc is field whether expert review is required, if the document is
dependent on another doc (e.g., doc B registers values in a dependent on another document (e.g., document B registers
registry created by doc A, which hasn't been published yet), values in a registry created by document A, which hasn't been
and if there is a registry expert appointment required. published yet), and if there is a registry expert appointment
required.
5) Version Changed -- Review Needed 5) Version Changed -- Review Needed
This substate will allow the community, Secretariat, and IANA This substate will allow the community, Secretariat, and IANA
to easily track which documents have been reviewed and to easily track which documents have been reviewed and
subsequently when a version of an Internet-Draft in Last Call subsequently when a version of an Internet-Draft in Last Call
has changed, therefore requiring a second review of the has changed, therefore requiring a second review of the
document by IANA to ensure that either the IANA Considerations document by IANA to ensure that either the IANA considerations
have not changed or that any changes made to the document have not changed, or any changes made to the document affecting
affecting IANA actions are clear. This substate applies to I- IANA actions are clear. This substate applies to I-Ds that are
Ds that are in any substate except "IANA Review Needed" and in any substate except "IANA Review Needed" and "Version
"Version Changed". Changed -- Review Needed".
When new versions are available, the Datatracker will When new versions are available, the Datatracker will
automatically set the IANA substate to "Version Changed -- automatically set the IANA substate to "Version Changed --
Review Needed". Review Needed".
Information providing the status of the IANA review (one of the 5 Information providing the status of the IANA review (one of the 5
substates listed above) should be included as part of the evaluation substates listed above) should be included as part of the evaluation
message (sent to the IESG) so that IANA can determine if and what message (sent to the IESG) so that IANA can determine if, and what,
further action is required. further action is required.
All comments will be recorded in the History log. However, to reduce All comments will be recorded in the History log. However, to reduce
redundancy and manual effort, the Datatracker should provide the redundancy and manual effort, the Datatracker should provide the
ability to receive state information and related comments from the ability to receive state information and related comments from the
IANA tracking system. There should be a notification that comments IANA tracking system. There should be a notification that comments
have been entered in the IANA-maintained system, and entry of those have been entered in the IANA-maintained system, and entry of those
comments into the datatracker and distribution of those comments to comments into the Datatracker and distribution of those comments to
the authors should be automated. the authors should be automated.
- IESG Evaluation - IESG Evaluation
As not all documents receive an IETF Last Call, this state is As not all documents receive an IETF Last Call, this state is
sometimes the first time that IANA reviews a document. For a sometimes the first time that IANA reviews a document. For a
document that wasn't IETF Last Called, IANA reviews the document, document that wasn't IETF Last Called, IANA reviews the document,
enters comments in their own tracking system, distributes email to enters comments in their own tracking system, distributes email to
authors and other interested parties (e.g., WG chairs, ISE), and authors and other interested parties (e.g., WG chairs, ISE
then enters those same comments into the Datatracker, where they (Independent Submissions Editor)), and then enters those same
are recorded in the History log. In cases where a document was comments into the Datatracker, where they are recorded in the
IETF Last Called, IANA checks for and reviews version changes and History log. In cases where a document was IETF Last Called, IANA
re-reviews documents to ensure that any identified IANA issues checks for and reviews version changes and re-reviews documents to
have been resolved. ensure that any identified IANA issues have been resolved.
Comments will continue to be recorded in the History log. Comments will continue to be recorded in the History log.
However, to reduce redundancy and manual effort, the Datatracker However, to reduce redundancy and manual effort, the Datatracker
should provide the ability for IANA to enter substate information should provide the ability for IANA to enter substate information
and related comments into the IANA tracking system, and and related comments into the IANA tracking system, and
distribution of those comments to the authors and entry into the distribution of those comments to the authors and entry into the
Datatracker should be automated. Datatracker should be automated.
Ideally, the authors will have responded to and resolved any IANA Ideally, the authors will have responded to and resolved any IANA
issues prior to the document being slated for an IESG telechat. issues prior to the document being slated for an IESG telechat.
However, if any document continues to have an "IANA Not OK", However, if any document continues to have an "IANA Not OK",
"Version Changed - Review Needed", or "IANA Review needed" "Version Changed -- Review Needed", or "IANA Review Needed"
substates and is slated for the IESG telechat, it should be called substate and is slated for the IESG telechat, it should be called
out in the Agenda Package. For example, it could appear as out in the Agenda Package. For example, it could appear as
follows: follows:
o draft-example-00 o draft-example-00
Title of Internet-Draft Title of Internet-Draft
Note: John Doe (jdoe@example.com) is the document shepherd. Note: John Doe (jdoe@example.com) is the document shepherd.
Token: Jane Doe Token: Jane Doe
IANA: IANA Not OK IANA: IANA Not OK
This will ensure that IANA and the ADs are aware that there are This will ensure that IANA and the Area Directors (ADs) are aware
still IANA considerations issues to be addressed prior to that there are still IANA issues to be addressed prior to
publication, or that initial or follow-up IANA Review is required publication, or that initial or follow-up IANA review is required
and not yet completed (in cases where the substate is listed as and not yet completed (in cases where the substate is listed as
"IANA review needed" or "Version Revision - Review Needed"). "IANA Review Needed" or "Version Changed -- Review Needed").
- Document Approved for Publication - Document Approved for Publication
Once a document has been approved for publication, the document Once a document has been approved for publication, the document
enters the IANA queue and is tracked using IANA-defined states. enters the IANA queue and is tracked using IANA-defined states.
This state information is not currently available via the This state information is not currently available via the
Datatracker. In order for the community to view the IANA Datatracker. In order for the community to view the IANA
processing states without being redirected to the IANA queue, the processing states without being redirected to the IANA queue, the
Datatracker should be extended to include IANA state information Datatracker should be extended to include IANA state information
as defined by IANA. For example, IANA state information could as defined by IANA. For example, IANA state information could
appear in the metadata portion of the document as follows: appear in the metadata portion of the document as follows:
Document type: Active Internet-Draft (FOO WG document) Document type: Active Internet-Draft (FOO WG document)
Last updated: 2010-09-20 Last updated: 2010-09-20
State: RFC Ed Queue State: RFC Ed Queue
RFC Editor State: EDIT IANA RFC Editor State: EDIT IANA
IANA State: In Progress IANA State: In Progress
Intended status: Proposed Standard Intended status: Proposed Standard
IANA state-change information will link to the IANA queue, and IANA state-change information will link to the IANA queue, and
will be captured as a line item in the History log. IANA will will be captured as a line item in the History log. IANA will
notify the Datatracker when changes are made in the IANA queue. notify the Datatracker when changes are made in the IANA queue.
Once the IANA actions have been completed, the Datatracker History Once the IANA actions have been completed, the Datatracker History
log will be updated to include the actions completed by IANA (the log will be updated to include the actions completed by IANA
author-approved actions). This will include the same information (i.e., the author-approved actions). This information will
that is sent to the RFC Editor once the actions upon completion of include the same information that is sent to the RFC Editor upon
IANA actions. completion of IANA actions.
The IANA State field may be any of the states defined by IANA. The IANA State field may be any of the states defined by IANA.
The list of IANA state names in use at the time this document was The list of IANA state names in use at the time this document was
published is provided in Appendix A; however, IANA states are published is provided in Appendix A; however, IANA states are
defined by IANA and are subject to change. If there are any defined by IANA and are subject to change. If there are any
discrepancies between the state names listed in this document and discrepancies between the state names listed in this document and
those listed on the IANA queue page those listed on the IANA queue page
(http://www.iana.org/about/performance/ietf-draft-status/), the (http://www.iana.org/about/performance/ietf-draft-status/), the
IANA queue is definitive. States may be added or removed by IANA; IANA queue is definitive. States may be added or removed by IANA;
IANA will work with the IAOC to update the Datatracker as IANA will work with the IETF Administrative Oversight Committee
necessary. (IAOC) to update the Datatracker as necessary.
- RFC Publication - RFC Publication
References to I-Ds are updated to refer to the RFC once published, References to the I-D are updated to refer to the RFC once it is
and minor updates may be made to match the published RFC. This published, and minor updates may be made to match the published
data will be tracked in the Datatracker to show when the RFC. This data will be tracked in the Datatracker to show when
references in the IANA registries were updated to include the the references in the IANA registries were updated to include the
newly assigned RFC Number. newly assigned RFC number.
2.2. Future IANA Information To Be Available Via the Datatracker 2.2. Future IANA Information to Be Available via the Datatracker
The document "Definition of IETF Working Group Document States" The document "Definition of IETF Working Group Document States"
[RFC6174] includes the following: [RFC6174] includes the following:
4.3.1. Awaiting Expert Review/Resolution of Issues Raised 4.3.1. Awaiting Expert Review/Resolution of Issues Raised
This tag means that someone (e.g. an author or editor of the WG This tag means that someone (e.g., an author or editor of the
draft, or a WG Chair) has initiated an expert review of the WG draft, or a WG Chair) has initiated an expert review of the
document and the review has not yet been completed and/or the document and the review has not yet been completed and/or the
resolution of issues raised by the review has not yet been resolution of issues raised by the review has not yet been
completed. Examples of expert reviews include cross-area completed. Examples of expert reviews include cross-area
reviews, MIB Doctor reviews, security expert reviews, and IANA reviews, MIB Doctor reviews, security expert reviews, and IANA
reviews. reviews.
WG drafts tagged with this annotation should retain the tag WG drafts tagged with this annotation should retain the tag
until the review is complete and possibly until any issues until the review is complete and possibly until any issues
raised in the review are addressed. raised in the review are addressed.
IANA is in the process of documenting how an expert review is IANA is in the process of documenting how an expert review is
conducted during the lifetime of an Internet-Draft. Once the process conducted during the lifetime of an Internet-Draft. Once the process
has been defined, the Datatracker should be updated to indicate if a has been defined, the Datatracker should be updated to indicate if a
document requires Expert Review [RFC5226] (either for the entire document requires "Expert Review" [RFC5226] (either for the entire
document or a portion thereof), if the Expert Reviewer has issues document or a portion thereof); if the expert reviewer has issues
with what they are being requested to review, and if applicable with what they are being requested to review; and, if applicable,
whether the Expert Reviewer has approved or rejected the requested whether the expert reviewer has approved or rejected the requested
registration(s). There may be a need to complete expert reviews registration(s). There may be a need to complete expert reviews
again before publication of a document if there have been changes to again before publication of a document if there have been changes to
the text relevant to the review by the expert. In cases where a new the text relevant to the review by the expert. In cases where a new
registry is being created in the document, an indicator of whether an registry is being created in the document, an indicator of whether an
expert needs to be appointed by the IESG would also be useful. expert needs to be appointed by the IESG would also be useful.
2.3. Permissions to Change IANA State Information 2.3. Permissions to Change IANA State Information
IANA state changes should be automated, but IANA should have the IANA state changes should be automated, but IANA should have the
ability to log in to the Datatracker to manually update the system as ability to log in to the Datatracker to manually update the system as
well. well.
Additionally, the IETF Secretariat should also have the ability to The IETF Secretariat should also have the ability to change the IANA
change the IANA state if necessary. state if necessary.
It is expected that this feature would only be used to correct It is expected that this feature would only be used to correct
issues; it is not intended to be part of regular operations. issues; it is not intended to be part of regular operations.
3. Integration of Data between the RFC Editor and Datatracker 3. Integration of Data between the RFC Editor and Datatracker
For quite some time, the RFC Editor was seen as a black box, where For quite some time, the RFC Editor was seen as a black box, where
documents were submitted for publication, went through some process, documents were submitted for publication, went through some process,
and came out as RFCs. Over time, the community asked for a more and came out as RFCs. Over time, the community asked for a more
transparent process; thus, state information was made available on transparent process; thus, state information was made available on
the RFC Editor website. Currently, some of that state information is the RFC Editor website. Currently, some of that state information is
available from the Datatracker. However, for additional transparency available from the Datatracker. However, for additional transparency
about the RFC Editor process, the Datatracker should be extended to about the RFC Editor process, the Datatracker should be extended to
hold supplementary RFC Editor state and process (e.g., MISSREF) hold supplementary RFC Editor state and process (e.g., MISSREF)
information. This section defines the requirements for RFC Editor information. This section defines the requirements for RFC Editor
state information to be added to the Datatracker to provide more state information to be added to the Datatracker to provide more
transparency and allow for a unified end-to-end tracking system. transparency and allow for a unified end-to-end tracking system.
3.1. RFC Editor Information To Be Added to the Datatracker 3.1. RFC Editor Information to Be Added to the Datatracker
Once a document has been approved for publication, the document Once a document has been approved for publication, the document
enters the RFC Editor queue and is tracked using RFC-Editor-defined enters the RFC Editor queue and is tracked using RFC-Editor-defined
states. Some RFC Editor state information is currently available via states. Some RFC Editor state information is currently available via
the Datatracker, but the information is not stored in the History the Datatracker, but the information is not stored in the History
log. RFC-Editor-defined state information will continue to be shown log. RFC-Editor-defined state information will continue to be shown
as is done currently. In addition, a line item will be entered into as is done currently. In addition, a line item will be entered into
the History log each time a document changes state. The RFC Editor the History log each time a document changes state. The RFC Editor
shall continue to provide a queue file to allow data extraction; in shall continue to provide a queue file to allow data extraction; in
addition, there will be a machine-readable notification to the addition, there will be a machine-readable notification to the
Datatracker when state changes are made. Datatracker when state changes are made.
RFC Editor state information should continue to appear in the RFC Editor state information should continue to appear in the
metadata portion of the document available using the Datatracker. metadata portion of the document available using the Datatracker.
For example, an entry might look as follows (including the IANA State For example, an entry might appear as follows (including the IANA
information): State information):
Document type: Active Internet-Draft (TLS WG document) Document type: Active Internet-Draft (TLS WG document)
Last updated: 2010-09-20 Last updated: 2010-09-20
State: RFC Ed Queue State: RFC Ed Queue
RFC Editor State: EDIT IANA RFC Editor State: EDIT IANA
IANA State: In Progress IANA State: In Progress
Intended status: Proposed Standard Intended status: Proposed Standard
The RFC Editor State field may be any of the states defined by the The RFC Editor State field may be any of the states defined by the
RFC Editor. The list of RFC Editor state names in use at the time RFC Editor. The list of RFC Editor state names in use at the time
this document was published is provided in Appendix B, but RFC Editor this document was published is provided in Appendix B, but RFC Editor
states are defined by the RFC Editor and are subject to change. If states are defined by the RFC Editor and are subject to change. If
there are any discrepancies between the state names listed in this there are any discrepancies between the state names listed in this
document and those listed on the RFC Editor queue page document and those listed on the RFC Editor queue page
(http://www.rfc-editor.org/queue.html), the RFC Editor queue is (http://www.rfc-editor.org/queue2.html), the RFC Editor queue is
definitive. States may be added or removed by the RFC Editor; the definitive. States may be added or removed by the RFC Editor; the
RFC Editor will work with the IAOC to update the Datatracker as RFC Editor will work with the IAOC to update the Datatracker as
necessary. necessary.
Although RFC Editor state information is already available in the Although RFC Editor state information is already available in the
Datatracker, the Datatracker should be updated to include some Datatracker, the Datatracker should be updated to include some
additional data that may help individuals understand the status of additional data that may help individuals understand the status of
their document. In particular, the Datatracker should be updated to their document. In particular, the Datatracker should be updated to
include the following data: include the following data:
skipping to change at page 10, line 27 skipping to change at page 10, line 45
significant updates before this data can be integrated with the significant updates before this data can be integrated with the
Datatracker. Datatracker.
3) RFC metadata upon publication 3) RFC metadata upon publication
The RFC Editor will notify the Datatracker when a new RFC has been The RFC Editor will notify the Datatracker when a new RFC has been
published, and the Datatracker should have the ability to published, and the Datatracker should have the ability to
automatically update the relevant fields with data related to the automatically update the relevant fields with data related to the
published RFC. In particular, the RFC number will be recorded in published RFC. In particular, the RFC number will be recorded in
the Datatracker. However, note that all fields are subject to the Datatracker. However, note that all fields are subject to
change during editing and should be updated; for example, document change during editing and should be updated; for example, the
title and the list of authors are sometimes changed, and character document title and the list of authors are sometimes changed, and
counts and page counts are always changed. character counts and page counts are always changed.
4) notation when documents are withdrawn from the RFC Editor queue 4) notation when documents are withdrawn from the RFC Editor queue
If a document is to be removed from the RFC Editor / IANA queues, If a document is to be removed from the RFC Editor / IANA queues,
the responsible party (e.g., AD or Secretariat) should change the the responsible party (e.g., AD or Secretariat) should change the
state of the Document in the Datatracker to something other than state of the document in the Datatracker to something other than
"RFC Ed Queue". The Datatracker should provide a text box to "RFC Ed Queue". The Datatracker should provide a text box to
allow the responsible party to record details about the state allow the responsible party to record details about the state
change. The state change and the related details will be recorded change. The state change and the related details will be recorded
in the History tab. The state change in the Datatracker will in the History log. The state change in the Datatracker will
trigger an email message to the RFC Editor and IANA as trigger an email message to the RFC Editor and IANA as
notification that the state of the doc has been set to "state" notification that the state of the document has been set to the
(the newly assigned state) with the details provided in the text newly assigned state, with the details provided in the text box.
box. The RFC Editor and IANA will update their queues The RFC Editor and IANA will update their queues accordingly, and
accordingly, and the document will disappear from their respective the document will disappear from their respective queues.
queues.
4. Other Updates to the Datatracker 4. Other Updates to the Datatracker
While the primary goal of this document is to update the Datatracker While the primary goal of this document is to update the Datatracker
to display the IANA and RFC Editor process state information, the to display the IANA and RFC Editor process state information, the
Datatracker could hold additional data for use by IANA and the RFC Datatracker could hold additional data for use by IANA and the RFC
Editor that would allow for increased automation, thus reducing the Editor that would allow for increased automation, thus reducing the
potential for delays and processing errors. This section defines potential for delays and processing errors. This section defines
requirements for updates to the Datatracker to eliminate some of the requirements for updates to the Datatracker to eliminate some of the
administrative tasks currently performed by staff. administrative tasks currently performed by staff.
skipping to change at page 11, line 18 skipping to change at page 11, line 40
4.1. Datatracker to IANA 4.1. Datatracker to IANA
When a document is approved for publication, data will be provided in When a document is approved for publication, data will be provided in
a machine-readable format and will include (in addition to the usual a machine-readable format and will include (in addition to the usual
Document/Protocol Action emails) the data requested by the RFC Editor Document/Protocol Action emails) the data requested by the RFC Editor
in Section 4.2. in Section 4.2.
4.2. Datatracker to RFC Editor 4.2. Datatracker to RFC Editor
When a document is approved for publication, data will be provided in When a document is approved for publication, data will be provided in
a machine readable format and will include the following (in addition a machine-readable format and will include the following (in addition
to the usual document/protocol action emails): to the usual Document/Protocol Action emails):
- I-D string - I-D String
- Document Title
- Author List - Document Title
- Author Email Addresses
- Author Organizations (if available) - Author List
- Expedited goal date (if applicable)
Note: this field needs to be editable for post-approval changes. - Author Email Addresses
- Publication Status (as defined in [RFC2026])
- Consensus (yes/no) - Author Organizations (if available)
- Source (Working Group or Research Group name, Individual, - Expedited Goal Date (if applicable)
or alternate stream name)
Note: The RFC Editor database may require updates before Research Note: This field needs to be editable for post-approval
Group data can be received from the Datatracker. changes.
- IESG Contact
- Document Shepherd <email> - Publication Status (as defined in [RFC2026])
Note: this is the individual currently listed in the "Personnel" section of
a Document/Protocol action. - Consensus (yes/no)
- IANA actions required
- Source (Working Group or Research Group name, Individual,
or alternate-stream name)
Note: The RFC Editor database may require updates before
Research Group data can be received from the Datatracker.
- IESG Contact
- Document Shepherd <email>
Note: This is the individual currently listed in the
"Personnel" section of a Document/Protocol Action.
- IANA Actions Required
Most of these items are already stored in the Datatracker. However, Most of these items are already stored in the Datatracker. However,
the following fields need to be added: the following fields need to be added:
- Expedited goal date - Expedited Goal Date
- Consensus (yes/no)
- Document Shepherd <email> - Consensus (yes/no)
- IANA actions required
- Document Shepherd <email>
- IANA Actions Required
"Consensus" is as used in [RFC5741]; it determines the appropriate "Consensus" is as used in [RFC5741]; it determines the appropriate
Status of This Memo text to be applied to IETF and IRTF documents. Status of This Memo text to be applied to IETF and IRTF documents.
The Consensus field should be set by the responsible individuals and The Consensus field should be set by the responsible individuals, and
it should be listed in the Agenda Package provided before an IESG it should be listed in the Agenda Package provided before an IESG
telechat so that the Area Directors can quickly review the status of telechat so that the Area Directors can quickly review the status of
the documents under review and correct the field if Consensus was not the documents under review and correct the field if Consensus was not
received. received.
Additionally, the Agenda Package provided before an IESG telechat Additionally, the Agenda Package provided before an IESG telechat
should show the expiration date of the IETF Last Call. This will be should show the expiration date of the IETF Last Call. This will be
helpful for the ADs and the Secretariat to track the IETF Last Call helpful for the ADs and the Secretariat to track the IETF Last Call
timeline. timeline.
skipping to change at page 12, line 25 skipping to change at page 13, line 17
sent to the Secretariat as acknowledgment that the announcement has sent to the Secretariat as acknowledgment that the announcement has
been received. been received.
4.2.1. Notifications 4.2.1. Notifications
The Datatracker should notify the RFC Editor and the Sponsoring AD The Datatracker should notify the RFC Editor and the Sponsoring AD
when a version of an I-D has been made available after the document when a version of an I-D has been made available after the document
has been approved for publication. has been approved for publication.
Additionally, the Datatracker should notify the RFC Editor and IANA Additionally, the Datatracker should notify the RFC Editor and IANA
when the state of an I-D has been moved to something than "RFC Ed when the state of an I-D has been moved to something other than "RFC
Queue" or "RFC Published" -- that is, when it should be removed from Ed Queue" or "RFC Published" -- that is, when it should be removed
the RFC Editor and IANA processing queues. See item 4) in Section from the RFC Editor and IANA processing queues. See item 4) in
3.1 for more detail. Section 3.1 for more details.
4.2.2. Datatracker Extensions for Alternate Streams 4.2.2. Datatracker Extensions for Alternate Streams
Once the Datatracker has been updated for the alternate streams Once the Datatracker has been updated for the alternate streams
[ALT-STREAMS], the Datatracker should be updated so that the [RFC6322], the Datatracker should be updated so that the following
following are automated: are automated:
- the Datatracker should not expire any I-Ds that are under review - The Datatracker should not expire any I-Ds that are under review
for publication. for publication.
- the Datatracker should automatically notify the approving body - The Datatracker should automatically notify the approving body
when an I-D that is under review has been updated (i.e., a new when an I-D that is under review has been updated (i.e., a new
version has been made available). version has been made available).
- the Datatracker should be updated to list I-Ds according to the - The Datatracker should be updated so that the Agenda package lists
stream that requested publication in the Agenda Package. This I-Ds according to the stream that requested publication. This
should help provide additional clarity during IESG reviews, as should help provide additional clarity during IESG Reviews, as
there will be a clear indication of from which stream a document there will be a clear indication of from which stream a document
originates. originates.
4.2.2.1. Publication Requests 4.2.2.1. Publication Requests
"Data Tracker States and Annotations for the IAB, IRTF, and RFC 6322 [RFC6322] lists the requirements for extending the
Independent Submission Streams" [ALT-STREAMS] lists the requirements Datatracker to account for alternate-stream states and annotations.
for extending the Datatracker to account for alternate stream states In particular, the document introduces the "Sent to the RFC Editor"
and annotations. In particular, the document introduces the "Sent to state, which means the document is complete and has been sent to the
the RFC Editor" state, which means the document is complete and has RFC Editor for publication.
been sent to the RFC Editor for publication.
The Datatracker will provide a means for the alternate streams to The Datatracker will provide a means for the alternate streams to
generate a uniform publication request. Using the Datatracker, the generate a uniform publication request. Using the Datatracker, the
stream managers should be able to generate a publication request that stream managers should be able to generate a publication request that
contains the relevant information for any approved I-D. contains the relevant information for any approved I-D.
Additionally, the Datatracker will provide the data (the same data Additionally, the Datatracker will provide the data (the same data
provided for any IETF publication request -- see Section 4.2) in a provided for any IETF publication request -- see Section 4.2) in a
machine-readable format. This data will be available to the IANA and machine-readable format. This data will be available to the IANA and
RFC Editor, so that data entry into the IANA and RFC Editor systems RFC Editor, so that data entry into the IANA and RFC Editor systems
can be automated. can be automated.
This update will allow the IANA and RFC Editor to handle documents in This update will allow the IANA and RFC Editor to handle documents in
a similar manner, regardless of the document's stream. a similar manner, regardless of the document's stream.
4.3. Reporting Requirements 4.3. Reporting Requirements
skipping to change at page 13, line 35 skipping to change at page 14, line 22
a similar manner, regardless of the document's stream. a similar manner, regardless of the document's stream.
4.3. Reporting Requirements 4.3. Reporting Requirements
The Datatracker should have a "Show Discrepancies" feature. It The Datatracker should have a "Show Discrepancies" feature. It
should show all records in the Datatracker that fit certain criteria should show all records in the Datatracker that fit certain criteria
(that seem to be a discrepancy). In addition to showing data on (that seem to be a discrepancy). In addition to showing data on
screen, it should send an email to defined interested parties at screen, it should send an email to defined interested parties at
regular intervals (e.g., weekly). This feature will only be regular intervals (e.g., weekly). This feature will only be
available to a subset of individuals (namely, IANA, RFC Editor, and available to a subset of individuals (namely, IANA, RFC Editor, and
the Secretariat), to ensure that our queues are in sync. This will the Secretariat), to ensure that their queues are in sync. This will
be especially helpful as the Datatracker is extended (now and in the be especially helpful as the Datatracker is extended (now and in the
future), to ensure that all parties are receiving the correct future), to ensure that all parties are receiving the correct
messages/data. messages/data.
An initial set of discrepancies should be defined, and additional An initial set of discrepancies should be defined, and additional
discrepancies could be defined over time. For example, the initial discrepancies could be defined over time. For example, the initial
set of discrepancies could include: set of discrepancies could include the following:
- Show drafts that have passed through the state "Approved - Show drafts that have passed through the state "Approved
Announcement sent" but do not have an RFC Editor state. Announcement sent" but do not have an RFC Editor state.
- Show drafts that have IANA state "In Progress" but RFC Editor - Show drafts that have IANA state "In Progress", but RFC Editor
State is not equal to "IANA" or does not contain "*A" (see State is not equal to "IANA" or does not contain "*A" (see
Appendix B). Appendix B).
- Show drafts that have IANA state "Waiting on RFC Editor" or "RFC- - Show drafts that have IANA state "Waiting on RFC Editor" or
Ed-Ack", but RFC Editor State is "IANA" or contains "*A" (See "RFC-Ed-Ack", but RFC Editor State is "IANA" or contains "*A"
Appendix B). (see Appendix B).
- Show drafts that have a state of something other than "RFC Ed - Show drafts that have a state of something other than "RFC Ed
Queue" or "RFC Published" that are listed in the RFC Editor or Queue" or "RFC Published" that are listed in the RFC Editor or
IANA queues. IANA queues.
5. IANA Considerations 5. Security Considerations
This document does not request any IANA registrations.
6. Security Considerations
This document does not propose any new Internet mechanisms, and has This document does not propose any new Internet mechanisms, and has
no security implications for the Internet. no security implications for the Internet.
Appendix A. Current IANA States and Definitions Appendix A. Current IANA States and Definitions
The currently defined IANA states are listed below. The currently defined IANA states are listed below.
* No value (blank) - A new document has been received by IANA, but * No value (blank) - A new document has been received by IANA, but
no actions have been taken no actions have been taken
skipping to change at page 15, line 11 skipping to change at page 15, line 11
This document does not propose any new Internet mechanisms, and has This document does not propose any new Internet mechanisms, and has
no security implications for the Internet. no security implications for the Internet.
Appendix A. Current IANA States and Definitions Appendix A. Current IANA States and Definitions
The currently defined IANA states are listed below. The currently defined IANA states are listed below.
* No value (blank) - A new document has been received by IANA, but * No value (blank) - A new document has been received by IANA, but
no actions have been taken no actions have been taken
* In Progress - IANA is currently processing the actions for this * In Progress - IANA is currently processing the actions for this
document document
* Waiting on Authors - IANA is waiting on the document's authors * Waiting on Authors - IANA is waiting on the document's authors
to respond to respond
* Waiting on ADs - IANA is waiting on the IETF Area Directors to * Waiting on ADs - IANA is waiting on the IETF Area Directors to
respond respond
* Waiting on WGC - IANA is waiting on the IETF Working Group * Waiting on WGC - IANA is waiting on the IETF Working Group
Chairs to respond Chairs to respond
* Waiting on RFC Editor - IANA has notified the RFC Editor that * Waiting on RFC Editor - IANA has notified the RFC Editor that
the actions have been completed the actions have been completed
* RFC-Ed-Ack - Request completed. The RFC Editor has acknowledged
* RFC-Ed-Ack - Request completed. The RFC Editor has acknowledged
receipt of IANA's message that the actions have been completed receipt of IANA's message that the actions have been completed
* On Hold - IANA has suspended work on the document * On Hold - IANA has suspended work on the document
* No IC - Request completed. There were no IANA actions for this
* No IC - Request completed. There were no IANA actions for this
document document
IANA states are defined by IANA and are subject to change. If there IANA states are defined by IANA and are subject to change. If there
are any discrepancies between the state names listed in this document are any discrepancies between the state names listed in this document
and those listed on the IANA queue page and those listed on the IANA queue page
(http://www.iana.org/about/performance/ietf-draft-status/), the IANA (http://www.iana.org/about/performance/ietf-draft-status/), the IANA
queue is definitive. queue is definitive.
Appendix B. Current RFC Editor States and Definitions Appendix B. Current RFC Editor States and Definitions
skipping to change at page 15, line 38 skipping to change at page 16, line 10
are any discrepancies between the state names listed in this document are any discrepancies between the state names listed in this document
and those listed on the IANA queue page and those listed on the IANA queue page
(http://www.iana.org/about/performance/ietf-draft-status/), the IANA (http://www.iana.org/about/performance/ietf-draft-status/), the IANA
queue is definitive. queue is definitive.
Appendix B. Current RFC Editor States and Definitions Appendix B. Current RFC Editor States and Definitions
The currently defined RFC Editor Queue states are listed below. The currently defined RFC Editor Queue states are listed below.
* AUTH = Awaiting Author Action * AUTH = Awaiting Author Action
* AUTH48 = Awaiting final author approval * AUTH48 = Awaiting final author approval
* EDIT = Approved by the stream manager (e.g., IESG, IAB, IRSG, * EDIT = Approved by the stream manager (e.g., IESG, IAB, IRSG,
ISE), awaiting processing and publishing ISE), awaiting processing and publishing
* IANA = RFC-Editor/IANA Registration Coordination * IANA = RFC-Editor/IANA Registration Coordination
* IESG = Holding for IESG Action * IESG = Holding for IESG Action
* ISR = Independent Submission Review by the ISE * ISR = Independent Submission Review by the ISE
* ISR-AUTH = Independent Submission awaiting author update, or in * ISR-AUTH = Independent Submission awaiting author update, or in
* discussion between author and ISE discussion between author and ISE
* REF = Holding for normative reference (followed by I-D string of * REF = Holding for normative reference (followed by I-D string of
* referenced document) referenced document)
* RFC-EDITOR = Awaiting final rfc-editor review before AUTH48 * RFC-EDITOR = Awaiting final rfc-editor review before AUTH48
* TO = Time-out period during which the IESG reviews document for * TO = Time-out period during which the IESG reviews document for
* conflict/concurrence with other IETF working group work conflict/concurrence with other IETF working group work
(followed by date) (followed by date)
* MISSREF = Awaiting missing normative reference.
* MISSREF = Awaiting missing normative reference
RFC Editor states are defined by the RFC Editor and are subject to RFC Editor states are defined by the RFC Editor and are subject to
change. If there are any discrepancies between the state names change. If there are any discrepancies between the state names
listed in this document and those listed on the RFC Editor queue page listed in this document and those listed on the RFC Editor queue page
(http://www.rfc-editor.org/queue2.html), the RFC Editor queue is (http://www.rfc-editor.org/queue2.html), the RFC Editor queue is
definitive. definitive.
Currently, there are also a couple of state annotations used in RFC Currently, there are also a couple of state annotations used in RFC
Editor state-change emails. These do not alter the Datatracker in Editor state-change emails. These do not alter the Datatracker in
any way, but are listed here for completeness: any way, but are listed here for completeness:
*A = indicates that IANA actions are required *A = indicates that IANA actions are required
*R = indicates potential REFerence holds *R = indicates potential REFerence holds
Normative References Normative References
[ALT-STREAMS] Hoffman, P., "Data Tracker States and Annotations for [IDTRACKER] "The IETF Datatracker tool", Web Application:
the IAB, IRTF, and Independent Submission Streams", https://datatracker.ietf.org/, August 26, 2011.
draft-hoffman-alt-streams-tracker, September 2010.
[IDTRACKER] "The IETF Datatracker tool", Web Application: [RFC2026] Bradner, S., "The Internet Standards Process --
https://datatracker.ietf.org/, September 15, 2010. Revision 3", BCP 9, RFC 2026, October 1996.
[RFC2026] Bradner, S., "The Internet Standards Process -- [RFC4844] Daigle, L., Ed., and Internet Architecture Board, "The
Revision 3", BCP 9, RFC 2026, October 1996. RFC Series and RFC Editor", RFC 4844, July 2007.
[RFC4844] Daigle, L., Ed., and Internet Architecture Board, "The [RFC5226] Narten, T. and H. Alvestrand, "Guidelines for Writing an
RFC Series and RFC Editor", RFC 4844, July 2007. IANA Considerations Section in RFCs", BCP 26, RFC 5226,
May 2008.
[RFC5226] Narten, T. and H. Alvestrand, "Guidelines for Writing [RFC5741] Daigle, L., Ed., Kolkman, O., Ed., and IAB, "RFC Streams,
an IANA Considerations Section in RFCs", BCP 26, RFC Headers, and Boilerplates", RFC 5741, December 2009.
5226, May 2008.
[RFC5741] Daigle, L., Ed., Kolkman, O., Ed., and IAB, "RFC [RFC6174] Juskevicius, E., "Definition of IETF Working Group
Streams, Headers, and Boilerplates", RFC 5741, December Document States", RFC 6174, March 2011.
2009.
[RFC6174] Juskevicius, E., "Definition of IETF Working Group [RFC6322] Hoffman, P., "Datatracker States and Annotations for the
Document States", RFC 6174, March 2011. IAB, IRTF, and Independent Submission Streams", RFC 6322,
July 2011.
Acknowledgments Acknowledgments
The authors would like to thank the following individuals for their The authors would like to thank the following individuals for their
input: input:
Amanda Baber Amanda Baber
Glen Barney Glen Barney
Adrian Farrel Adrian Farrel
Alice Hagens Alice Hagens
Paul Hoffman Paul Hoffman
Russ Housley Russ Housley
Ed Juskevicius Ed Juskevicius
Henrik Levkowetz Henrik Levkowetz
Cindy Morgan Cindy Morgan
Ray Pelletier Ray Pelletier
Rober Sparks Peter Saint-Andre
Peter St. Andre Robert Sparks
Amy Vezza Amy Vezza
Authors' Addresses Authors' Addresses
Sandy Ginoza Sandy Ginoza
Association Management Solutions Association Management Solutions
48377 Fremont Blvd., Suite 117 48377 Fremont Blvd., Suite 117
Fremont, CA 94538 Fremont, CA 94538
United States United States
 End of changes. 88 change blocks. 
191 lines changed or deleted 225 lines changed or added

This html diff was produced by rfcdiff 1.41. The latest version is available from http://tools.ietf.org/tools/rfcdiff/