Guidance on Interoperation and Implementation Reports for Advancement to Draft Standard
RFC 5657

 
Document Type RFC - Best Current Practice (September 2009; Errata)
Updates RFC 2026
Was draft-dusseault-impl-reports (individual in gen area)
Last updated 2013-03-02
Stream IETF
Formats plain text pdf html
Stream WG state (None)
Consensus Unknown
Document shepherd No shepherd assigned
IESG IESG state RFC 5657 (Best Current Practice)
Telechat date
Responsible AD Tim Polk
Send notices to RjS@nostrum.com, ldusseault@commerce.net, draft-dusseault-impl-reports@ietf.org

Email authors IPR References Referenced by Nits Search lists

Network Working Group                                       L. Dusseault
Request for Comments: 5657                          Messaging Architects
BCP: 9                                                         R. Sparks
Updates: 2026                                                    Tekelec
Category: Best Current Practice                           September 2009

         Guidance on Interoperation and Implementation Reports
                   for Advancement to Draft Standard

Abstract

   Advancing a protocol to Draft Standard requires documentation of the
   interoperation and implementation of the protocol.  Historic reports
   have varied widely in form and level of content and there is little
   guidance available to new report preparers.  This document updates
   the existing processes and provides more detail on what is
   appropriate in an interoperability and implementation report.

Status of This Memo

   This document specifies an Internet Best Current Practices for the
   Internet Community, and requests discussion and suggestions for
   improvements.  Distribution of this memo is unlimited.

Copyright and License Notice

   Copyright (c) 2009 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 BSD License.

Dusseault & Sparks       Best Current Practice                  [Page 1]
RFC 5657             Implementation Report Guidance       September 2009

Table of Contents

   1. Introduction ....................................................2
   2. Content Requirements ............................................4
   3. Format ..........................................................5
   4. Feature Coverage ................................................6
   5. Special Cases ...................................................8
      5.1. Deployed Protocols .........................................8
      5.2. Undeployed Protocols .......................................8
      5.3. Schemas, Languages, and Formats ............................8
      5.4. Multiple Contributors, Multiple Implementation Reports .....9
      5.5. Test Suites ................................................9
      5.6. Optional Features, Extensibility Features .................10
   6. Examples .......................................................10
      6.1. Minimal Implementation Report .............................11
      6.2. Covering Exceptions .......................................11
   7. Security Considerations ........................................11
   8. References .....................................................12
      8.1. Normative References ......................................12
      8.2. Informative References ....................................12

1.  Introduction

   The Draft Standard level, and requirements for standards to meet it,
   are described in [RFC2026].  For Draft Standard, not only must two
   implementations interoperate, but also documentation (the report)
   must be provided to the IETF.  The entire paragraph covering this
   documentation reads:

      The Working Group chair is responsible for documenting the
      specific implementations which qualify the specification for Draft
      or Internet Standard status along with documentation about testing
      of the interoperation of these implementations.  The documentation
      must include information about the support of each of the
      individual options and features.  This documentation should be
      submitted to the Area Director with the protocol action request.
      (see Section 6)

   Moving documents along the standards track can be an important signal
   to the user and implementor communities, and the process of
   submitting a standard for advancement can help improve that standard
   or the quality of implementations that participate.  However, the
   barriers seem to be high for advancement to Draft Standard, or at the
   very least confusing.  This memo may help in guiding people through
   one part of advancing specifications to Draft Standard.  It also
   changes some of the requirements made in RFC 2026 in ways that are
   intended to maintain or improve the quality of reports while reducing
   the burden of creating them.

Dusseault & Sparks       Best Current Practice                  [Page 2]
Show full document text