Requesting Comments: Enabling Readers to Annotate RFCs
draft-sheffer-ietf-rfc-annotations-01

Document Type Active Internet-Draft (individual)
Last updated 2016-12-27
Stream (None)
Intended RFC status (None)
Formats plain text xml pdf html bibtex
Stream Stream state (No stream defined)
Consensus Boilerplate Unknown
RFC Editor Note (None)
IESG IESG state I-D Exists
Telechat date
Responsible AD (None)
Send notices to (None)
Network Working Group                                         Y. Sheffer
Internet-Draft                                                    Intuit
Intended status: Informational                         December 27, 2016
Expires: June 30, 2017

         Requesting Comments: Enabling Readers to Annotate RFCs
                 draft-sheffer-ietf-rfc-annotations-01

Abstract

   RFCs were initially intended as, literally, requests for comments.
   Since then, they have turned into standards documents, with a
   peculiar process to report errors and a highly onerous process to
   actually have the RFC modified/republished.  Non-IETF participants
   are typically unaware of any way to provide feedback to published
   RFCs, other than direct email to the listed authors.  This is very
   different from the way many web specifications are developed today
   and arguably leads to the value of published RFCs diminishing over
   time.  This document proposes an experiment to remedy this situation
   through the deployment of web annotations.

Status of This Memo

   This Internet-Draft is submitted in full conformance with the
   provisions of BCP 78 and BCP 79.

   Internet-Drafts are working documents of the Internet Engineering
   Task Force (IETF).  Note that other groups may also distribute
   working documents as Internet-Drafts.  The list of current Internet-
   Drafts is at http://datatracker.ietf.org/drafts/current/.

   Internet-Drafts are draft documents valid for a maximum of six months
   and may be updated, replaced, or obsoleted by other documents at any
   time.  It is inappropriate to use Internet-Drafts as reference
   material or to cite them other than as "work in progress."

   This Internet-Draft will expire on June 30, 2017.

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

Sheffer                   Expires June 30, 2017                 [Page 1]
Internet-Draft               RFC Annotations               December 2016

   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.

1.  Introduction

   IETF participants use the term "RFC" on a daily basis.  We all know
   that "RFC" stands for "Request for Comments".  However the RFCs we
   publish are anything but requests for comments.  RFCs today are
   static documents that do not invite comments.  Acute readers who
   insist on providing feedback will find the following text:
   "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/rfcXXXX."  Once on this page, they will only find the
   email address of a working group, which may long be defunct.

   We can do better than that.  This document proposes, as a process
   experiment [RFC3933], to enable web annotations on published RFCs.
   The target audience is non-IETF participants, essentially the IETF's
   customers.  We discuss the advantages of such a system and the risks
   associated with it.

1.1.  Conventions used in this document

   The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT",
   "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this
   document are to be interpreted as described in [RFC2119].

2.  Overview

   We propose to enable, for an initial period of 1 year, annotations on
   published RFCs.  Document readers will be able to attach textual
   comments to published RFCs, and these comments will be public,
   visible to all other readers who will also be able to respond to
   them.

   Specifically, we recommend using the Hypothesis
   (https://hypothes.is/) system on our "tools" RFCs,
   https://tools.ietf.org/html/rfcXXXX.  We propose not to build any
   custom infrastructure around this system but rather to use it as-is.
   When the experiment is done, we will publish an experiment report
   which will enable the IETF to decide whether this is of benefit for
   the long term.

Sheffer                   Expires June 30, 2017                 [Page 2]
Internet-Draft               RFC Annotations               December 2016
Show full document text