Re: [quicwg/base-drafts] Update Contributing.md to reflect post-IESG world (#4824)

Jana Iyengar <notifications@github.com> Thu, 04 February 2021 02:55 UTC

Return-Path: <noreply@github.com>
X-Original-To: quic-issues@ietfa.amsl.com
Delivered-To: quic-issues@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id 8F2533A1183 for <quic-issues@ietfa.amsl.com>; Wed, 3 Feb 2021 18:55:39 -0800 (PST)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -3.349
X-Spam-Level:
X-Spam-Status: No, score=-3.349 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIMWL_WL_HIGH=-0.25, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=0.001, MAILING_LIST_MULTI=-1, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, URIBL_BLOCKED=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (1024-bit key) header.d=github.com
Received: from mail.ietf.org ([4.31.198.44]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id re0vwx3vmIZC for <quic-issues@ietfa.amsl.com>; Wed, 3 Feb 2021 18:55:37 -0800 (PST)
Received: from out-27.smtp.github.com (out-27.smtp.github.com [192.30.252.210]) (using TLSv1.2 with cipher ADH-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id 850473A1184 for <quic-issues@ietf.org>; Wed, 3 Feb 2021 18:55:37 -0800 (PST)
Received: from github.com (hubbernetes-node-15cfc7c.ash1-iad.github.net [10.56.112.29]) by smtp.github.com (Postfix) with ESMTPA id E86DA900139 for <quic-issues@ietf.org>; Wed, 3 Feb 2021 18:55:34 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=github.com; s=pf2014; t=1612407334; bh=Mx1YCbMunza4rXGV99wggXlyGUfhg0owbf+sLgJ77Ac=; h=Date:From:Reply-To:To:Cc:In-Reply-To:References:Subject:List-ID: List-Archive:List-Post:List-Unsubscribe:From; b=WsD3lNP96LTzKLnCYSu+7RzYRFJRM1LtxEVBjf8FhxBL5idxTLQ/6yJ7/YHvXu4OZ 8VI08YEt8ttz4IrCXnxbR4NY8pp93Kwfq5V4NZCOLMTw2jbf+HRdeN95UYtfKb2Wc1 sop7J6DTJOhNtJ49lOUsTJS8x+YX09ZS7nxzuJD8=
Date: Wed, 03 Feb 2021 18:55:34 -0800
From: Jana Iyengar <notifications@github.com>
Reply-To: quicwg/base-drafts <reply+AFTOJKY736PHOODZLBXIRJV6E5BSNEVBNHHC7PB7QI@reply.github.com>
To: quicwg/base-drafts <base-drafts@noreply.github.com>
Cc: Subscribed <subscribed@noreply.github.com>
Message-ID: <quicwg/base-drafts/pull/4824/review/582991653@github.com>
In-Reply-To: <quicwg/base-drafts/pull/4824@github.com>
References: <quicwg/base-drafts/pull/4824@github.com>
Subject: Re: [quicwg/base-drafts] Update Contributing.md to reflect post-IESG world (#4824)
Mime-Version: 1.0
Content-Type: multipart/alternative; boundary="--==_mimepart_601b6226e4eeb_e711a043193d0"; charset="UTF-8"
Content-Transfer-Encoding: 7bit
Precedence: list
X-GitHub-Sender: janaiyengar
X-GitHub-Recipient: quic-issues
X-GitHub-Reason: subscribed
X-Auto-Response-Suppress: All
X-GitHub-Recipient-Address: quic-issues@ietf.org
Archived-At: <https://mailarchive.ietf.org/arch/msg/quic-issues/SLZsi4lwripNh9OjHiy6lTaU-Qw>
X-BeenThere: quic-issues@ietf.org
X-Mailman-Version: 2.1.29
List-Id: Notification list for GitHub issues related to the QUIC WG <quic-issues.ietf.org>
List-Unsubscribe: <https://www.ietf.org/mailman/options/quic-issues>, <mailto:quic-issues-request@ietf.org?subject=unsubscribe>
List-Archive: <https://mailarchive.ietf.org/arch/browse/quic-issues/>
List-Post: <mailto:quic-issues@ietf.org>
List-Help: <mailto:quic-issues-request@ietf.org?subject=help>
List-Subscribe: <https://www.ietf.org/mailman/listinfo/quic-issues>, <mailto:quic-issues-request@ietf.org?subject=subscribe>
X-List-Received-Date: Thu, 04 Feb 2021 02:55:40 -0000

@janaiyengar commented on this pull request.

a few editorial comments

> +* Invariants
+* Transport
+* TLS
+* HTTP/3
+* QPACK
+* Recovery

Replace these with document names?

> @@ -21,12 +27,17 @@ new to this, you may also want to read the [Tao of the IETF](https://www.ietf.or
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
+# Engaging with the QUIC community
+
+The QUIC Working Group scope of work is described in our charter and it extends beyond the development of the documents held in this repository. Anyone is welcome to contribute to the QUIC community; you don't have to join the Working Group, because there is no "membership" -- anyone who participates in the work **is** a part of the QUIC Working Group.

```suggestion
The scope of work in the QUIC Working Group is described in our charter and extends beyond the development of the documents in this repository. Anyone is welcome to contribute to the QUIC Working Group; you don't have to join the Working Group, because there is no "membership" -- anyone who participates in the work **is** a part of the QUIC Working Group.
```

> @@ -21,12 +27,17 @@ new to this, you may also want to read the [Tao of the IETF](https://www.ietf.or
 
 <!-- END doctoc generated TOC please keep comment here to allow auto update -->
 
+# Engaging with the QUIC community
+
+The QUIC Working Group scope of work is described in our charter and it extends beyond the development of the documents held in this repository. Anyone is welcome to contribute to the QUIC community; you don't have to join the Working Group, because there is no "membership" -- anyone who participates in the work **is** a part of the QUIC Working Group.
+
+Before doing so, it's a good idea to familiarize yourself with our [charter](https://datatracker.ietf.org/wg/quic/about/). If you're new to IETF work, you may also want to read the [Tao of the IETF](https://www.ietf.org/tao.html).

```suggestion
Before doing so, please familiarize yourself with our [charter](https://datatracker.ietf.org/wg/quic/about/). If you are new to IETF work, you may also want to read the [Tao of the IETF](https://www.ietf.org/tao.html).
```

>  
 ## Following Discussion
 
 The Working Group has a few venues for discussion:
 
-* We plan to meet at all [IETF meetings](https://www.ietf.org/meeting/) for the foreseeable future, and hold interim meetings between them. See our [meeting materials repository](https://github.com/quicwg/wg-materials) and the [official proceedings](https://datatracker.ietf.org/wg/quic/meetings/).
+* We plan to meet at all [IETF meetings](https://www.ietf.org/meeting/) for the foreseeable future, and possibly hold interim meetings between them if required. Agendas, minutes and presentations are available in our [meeting materials repository](https://github.com/quicwg/wg-materials) and the [official proceedings](https://datatracker.ietf.org/wg/quic/meetings/).

```suggestion
* We plan to meet at all [IETF meetings](https://www.ietf.org/meeting/) for the foreseeable future, and hold interim meetings between them as required. Agendas, minutes, and presentations are available in our [meeting materials repository](https://github.com/quicwg/wg-materials) and the [official proceedings](https://datatracker.ietf.org/wg/quic/meetings/).
```

>  
-We use our [Github](https://github.com/quicwg/) issues lists to track items for discussion and
-their resolution.
+The Working Group has built consensus that is reflected in base-draft documents, which has been confirmed through the IETF Last Call and IESG review stages modulo any critical undiscovered issues. Design changes will no longer be considered unless there are severe security, deployment or implementation problems. modulo any open (or undiscovered) issues. The goal of the Post-IESG proces is to minimise changes that invalidate the accumulated consesus, which risks returning us to the pre Working Group Last Call stage of standardisation.

```suggestion
The consensus of the Working Group is reflected in the base-draft documents, which has been confirmed through the IETF Last Call and IESG review stages. The goal of the Post-IESG process is to minimize the risk of changes invalidating the established consensus in these documents. Consequently, design changes and substantial editorial changes will no longer be considered unless they relate to severe security, deployment, or implementation problems.
```

>  
-Before filing a new issue, please consider a few things:
+In this process, all required parties will discuss each design or major editorial issue and proposed resolution (ideally based upon a Pull Request that specifies the exact changes to be made). Chairs will judge consensus, labelling the issue as `has-consensus`.

For clarity, can you list the "required parties"?

>  
-* Issues should be just that; issues with our deliverables, **not proposals, questions or support requests**.
-* Please review the issues list to make sure that you aren't filing a duplicate.
-* If you're not sure how to phrase your issue, please ask on the [mailing list](https://www.ietf.org/mailman/listinfo/quic).
+### Raising Issues
+
+We will no longer consider Design changes or substantial Editorial changes unless they relate to severe security, interoperabily or deployment problems.

```suggestion
We will no longer consider design changes or substantial editorial changes unless they relate to severe security, deployment, or implementation problems.
```

> +We use our [Github](https://github.com/quicwg/) issues lists to track items for discussion and
+their resolution.

```suggestion
We will continue to use our [Github](https://github.com/quicwg/) issues lists to track items for discussion and their resolution.
```

>  
 Issues will be labeled by the Chairs as either `editorial` or `design`:
 
-* **Design** issues require discussion and consensus in the Working Group. This discussion can happen both in the issue and on the [Working Group mailing list](https://www.ietf.org/mailman/listinfo/quic), as outlined below.
+* **Design** issues require discussion and consensus among the Working Group, Area Director and IESG. This discussion can happen both in the issue and on the [Working Group mailing list](https://www.ietf.org/mailman/listinfo/quic), and all other relavent mailing lists.

```suggestion
* **Design** issues require discussion and consensus among the Working Group, the Area Director, and the IESG. This discussion can happen in the issue, on the [Working Group mailing list](https://www.ietf.org/mailman/listinfo/quic), or other relevant mailing lists.
```

>  
-* **Editorial** issues can be dealt with by the editor(s) without consensus or notification. Typically, any discussion will take place on the issue itself.
+* **Editorial** issues that or minor or unsubstantial can be dealt with by the editor(s) without consensus or notification. Larger editorial changes require discussion and and consensus among the Working Group, Area Director and IESG.

```suggestion
* **Editorial** issues that are minor can be dealt with by the editor(s) without consensus or notification. Larger editorial changes require discussion and and consensus among the Working Group, the Area Director, and the IESG.
```

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/quicwg/base-drafts/pull/4824#pullrequestreview-582991653