Tracking Reviews of Documents
RFC 7735

Document Type RFC - Informational (January 2016; No errata)
Was draft-sparks-genarea-review-tracker (individual in gen area)
Last updated 2016-01-13
Stream IETF
Formats plain text pdf html bibtex
Reviews
Stream WG state (None)
Document shepherd Pete Resnick
Shepherd write-up Show (last changed 2015-06-21)
IESG IESG state RFC 7735 (Informational)
Consensus Boilerplate Yes
Telechat date
Responsible AD Jari Arkko
Send notices to (None)
IANA IANA review state IANA OK - No Actions Needed
IANA action state No IC
Internet Engineering Task Force (IETF)                         R. Sparks
Request for Comments: 7735                                        Oracle
Category: Informational                                       T. Kivinen
ISSN: 2070-1721                                            INSIDE Secure
                                                            January 2016

                     Tracking Reviews of Documents

Abstract

   Several review teams ensure specific types of review are performed on
   Internet-Drafts as they progress towards becoming RFCs.  The tools
   used by these teams to assign and track reviews would benefit from
   tighter integration to the Datatracker.  This document discusses
   requirements for improving those tools without disrupting current
   work flows.

Status of This Memo

   This document is not an Internet Standards Track specification; it is
   published for informational purposes.

   This document is a product of the Internet Engineering Task Force
   (IETF).  It represents the consensus of the IETF community.  It has
   received public review and has been approved for publication by the
   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.

   Information about the current status of this document, any errata,
   and how to provide feedback on it may be obtained at
   http://www.rfc-editor.org/info/rfc7735.

Copyright Notice

   Copyright (c) 2016 IETF Trust and the persons identified as the
   document authors.  All rights reserved.

   This document is subject to BCP 78 and the IETF Trust's Legal
   Provisions Relating to IETF Documents
   (http://trustee.ietf.org/license-info) in effect on the date of
   publication of this document.  Please review these documents
   carefully, as they describe your rights and restrictions with respect
   to this document.  Code Components extracted from this document must
   include Simplified BSD License text as described in Section 4.e of
   the Trust Legal Provisions and are provided without warranty as
   described in the Simplified BSD License.

Sparks & Kivinen              Informational                     [Page 1]
RFC 7735                     Review Tracking                January 2016

Table of Contents

   1.  Introduction  . . . . . . . . . . . . . . . . . . . . . . . .   2
   2.  Overview of Current Workflows . . . . . . . . . . . . . . . .   3
   3.  Requirements  . . . . . . . . . . . . . . . . . . . . . . . .   5
     3.1.  Secretariat Focused . . . . . . . . . . . . . . . . . . .   5
     3.2.  Review-Team Secretary Focused . . . . . . . . . . . . . .   5
     3.3.  Reviewer Focused  . . . . . . . . . . . . . . . . . . . .   8
     3.4.  Review Requester and Consumer Focused . . . . . . . . . .  10
     3.5.  Statistics Focused  . . . . . . . . . . . . . . . . . . .  11
   4.  Security Considerations . . . . . . . . . . . . . . . . . . .  12
   5.  Informative References  . . . . . . . . . . . . . . . . . . .  12
   Appendix A.  A Starting Point for Django Models Supporting the
                Review Tool  . . . . . . . . . . . . . . . . . . . .  14
   Appendix B.  Suggested Features Deferred for Future Work  . . . .  15
   Acknowledgements  . . . . . . . . . . . . . . . . . . . . . . . .  16
   Authors' Addresses  . . . . . . . . . . . . . . . . . . . . . . .  16

1.  Introduction

   As Internet-Drafts are processed, reviews are requested from several
   review teams.  For example, the General Area Review Team (Gen-ART)
   and the Security Directorate (SecDir) perform reviews of documents
   that are in IETF Last Call.  Gen-ART always performs a follow-up
   review when the document is scheduled for an IESG Telechat.  SecDir
   usually performs a follow-up review, but the SecDir secretary may
   choose not to request that follow-up if any issues identified at Last
   Call are addressed and there are otherwise no major changes to the
   document.  These teams also perform earlier reviews of documents on
   demand.  There are several other teams that perform similar services,
   often focusing on specific areas of expertise.

   The secretaries of these teams manage a pool of volunteer reviewers.
   Documents are assigned to reviewers, taking various factors into
   account.  For instance, a reviewer will not be assigned a document
   for which he is an author or shepherd.  Reviewers are given a
   deadline, usually driven by the end of Last Call or an IESG Telechat
   date.  The reviewer sends each completed review to the team's mailing
   list and to any other lists that are relevant for the document being
   reviewed.  Often, a thread ensues on one or more of those lists to
   resolve any issues found in the review.
Show full document text