IESG Statement: Support Documents in IETF Working Groups

The IESG <iesg@ietf.org> Tue, 15 November 2016 02:53 UTC

Return-Path: <iesg@ietf.org>
X-Original-To: ietf-announce@ietf.org
Delivered-To: ietf-announce@ietfa.amsl.com
Received: from ietfa.amsl.com (localhost [IPv6:::1]) by ietfa.amsl.com (Postfix) with ESMTP id B2501129A06 for <ietf-announce@ietf.org>; Mon, 14 Nov 2016 18:53:24 -0800 (PST)
MIME-Version: 1.0
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 8bit
From: The IESG <iesg@ietf.org>
To: IETF Announcement List <ietf-announce@ietf.org>
Subject: IESG Statement: Support Documents in IETF Working Groups
X-Test-IDTracker: no
X-IETF-IDTracker: 6.37.1
Auto-Submitted: auto-generated
Precedence: bulk
Message-ID: <147917840468.8537.625814152732987731.idtracker@ietfa.amsl.com>
Date: Mon, 14 Nov 2016 18:53:24 -0800
Archived-At: <https://mailarchive.ietf.org/arch/msg/ietf-announce/EZi3owksw9TT6ym5ZbONHnv-Yl4>
X-BeenThere: ietf-announce@ietf.org
X-Mailman-Version: 2.1.17
Reply-To: ietf@ietf.org
List-Id: "IETF announcement list. No discussions." <ietf-announce.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/ietf-announce>, <mailto:ietf-announce-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/ietf-announce/>
List-Post: <mailto:ietf-announce@ietf.org>
List-Help: <mailto:ietf-announce-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/ietf-announce>, <mailto:ietf-announce-request@ietf.org?subject=subscribe>
X-List-Received-Date: Tue, 15 Nov 2016 02:53:27 -0000

There is a class of documents that help guiding a working group to agree 
on the problem(s) and even converge on a solution. These support 
documents can include, for example, problem statements, use cases, and 
requirements.

While support documents are important for the operation of a working 
group and to drive progress, perfecting and publishing those documents 
can consume scarce community resources, which in the end can delay the 
solution work. There is no formal expectation that requires the 
development and publication as RFCs of support documents in sequence 
before starting the solution work: problem statement, use cases, 
requirements, and then finally architecture and protocol specifications, 
for instance.

In order to speed up the time period from idea to running code, the IESG 
supports working groups that commence solution work early in the working 
group timeline, and do not wait for completion and publication of the 
support documents. When the problem scope is well understood and agreed 
upon, charters focused on solutions work are extremely efficient.

While writing down such things as requirements and use cases help to get 
a common understanding (and often common language) between participants 
in the working group, support documentation doesn’t always have a high 
archival value. Under most circumstances, the IESG encourages the 
community to consider alternate mechanisms for publishing this content, 
such as on a working group wiki, in an informational appendix of a 
solution document, or simply as an expired draft. As regards to timing, 
it would be worthwhile to discuss the need to publish support documents 
early during the charter development process in order to set the right 
expectations and minimize surprises at a late stage. Therefore, working 
group charters may direct the working group to publish this content 
using alternate mechanisms, or may instruct the working group to 
consider the appropriate mechanism as work proceeds.