Re: Proposal to migrate from QUIC GitHub wikis to quicwg.org

Lucas Pardue <lucas@lucaspardue.com> Tue, 30 July 2024 09:36 UTC

Return-Path: <lucas@lucaspardue.com>
X-Original-To: quic@ietfa.amsl.com
Delivered-To: quic@ietfa.amsl.com
Received: from localhost (localhost [127.0.0.1]) by ietfa.amsl.com (Postfix) with ESMTP id B4736C14F69F for <quic@ietfa.amsl.com>; Tue, 30 Jul 2024 02:36:42 -0700 (PDT)
X-Virus-Scanned: amavisd-new at amsl.com
X-Spam-Flag: NO
X-Spam-Score: -2.805
X-Spam-Level:
X-Spam-Status: No, score=-2.805 tagged_above=-999 required=5 tests=[BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, HTML_MESSAGE=0.001, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H4=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_ZEN_BLOCKED_OPENDNS=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01, URIBL_DBL_BLOCKED_OPENDNS=0.001, URIBL_ZEN_BLOCKED_OPENDNS=0.001] autolearn=ham autolearn_force=no
Authentication-Results: ietfa.amsl.com (amavisd-new); dkim=pass (2048-bit key) header.d=lucaspardue.com header.b="cg2xKVpY"; dkim=pass (2048-bit key) header.d=messagingengine.com header.b="a0T5xOvu"
Received: from mail.ietf.org ([50.223.129.194]) by localhost (ietfa.amsl.com [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id j-1M6xTvKd4m for <quic@ietfa.amsl.com>; Tue, 30 Jul 2024 02:36:38 -0700 (PDT)
Received: from fhigh3-smtp.messagingengine.com (fhigh3-smtp.messagingengine.com [103.168.172.154]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-256) server-digest SHA256) (No client certificate requested) by ietfa.amsl.com (Postfix) with ESMTPS id DAD4AC14F685 for <quic@ietf.org>; Tue, 30 Jul 2024 02:36:37 -0700 (PDT)
Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailfhigh.nyi.internal (Postfix) with ESMTP id CF00D1140758; Tue, 30 Jul 2024 05:36:35 -0400 (EDT)
Received: from wimap26 ([10.202.2.86]) by compute4.internal (MEProxy); Tue, 30 Jul 2024 05:36:35 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lucaspardue.com; h=cc:cc:content-type:content-type:date:date:from:from :in-reply-to:in-reply-to:message-id:mime-version:references :reply-to:subject:subject:to:to; s=fm1; t=1722332195; x= 1722418595; bh=DqCtupFHsOITESYiakY9OfNkPI/EhXQr8UVZDcEMPRU=; b=c g2xKVpYzyWJV07FrKYtFhQc1imvP5rtbuHbWC+7HuDsZNQBztF2hgO1L+XxjYQgI o/b/lXGbhi8+QC65IYBKcvnc0eHdc1RjIagI+90zX7WwrHIPXHbW3Eiru97hjuqn EIkHKKo6tzBhWTaR7C61laZXxmQAOvDhI9G1JDbQ1EnYVnoi1zcsOPbezrulHeTE bG9UfeVMIjiFOSTqt2ZXxvNSIdAvmVyalFrL5bPtQxKZyf5HAxRoGidskAhi3iOq R8OUmkYkH7u1JiLDYFEXrll7qmMkjwH7c345LLidbiIvEsx96EkwoNhVh7aD44M5 PPZVfEN0fEEs589oRg0Sg==
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-type:content-type:date:date :feedback-id:feedback-id:from:from:in-reply-to:in-reply-to :message-id:mime-version:references:reply-to:subject:subject:to :to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s= fm3; t=1722332195; x=1722418595; bh=DqCtupFHsOITESYiakY9OfNkPI/E hXQr8UVZDcEMPRU=; b=a0T5xOvu0MP7m86ICfqlSftuusqExGycYrGmgC8XP9+c BRFEgARE0n4ML+g0gAkztZSBA5OOC8w6YYSNR/YuA73l2EQdDEpto21RZLbtrEmp VNYYUsHgmfIhmF0xN1kQJAszR7/XAcuIso4r9GwQrcDCRdWqPqnhMGtgyClw3/JS QE1lkrzb8PbjxOM0J0TmmTemnF8dy0Fse0EEu5DQeoUTMedW8dRM3nKo2qKX+Jm8 ZWWUG9isJiC2/WuuJJ1rr8o2ytBBwYM8a2vauVCTg5UO+bUNla/jXoWortzCFQqF 8xGWLQq8w2laUmgrB5lr4Tg3YadBxOMicqc9+NVExw==
X-ME-Sender: <xms:I7SoZg1PoBbPS1ml0JzKGcDIuyITrCU-Q6nRieV75IH4AY8SBxOh1w> <xme:I7SoZrFyORfXtpKcysmOERpJGwxp-zXeWd6YmH20UVC3Ne_G1Ese40gYGuq2n9jv5 KjBHzt0KZ4-PKu5PAo>
X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeeftddrjeeggddukecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecuogfuuhhsphgvtghtffhomhgrihhnucdlgeelmdenuc fjughrpefoggffhffvvefkjghfufgtsegrtderreertddtnecuhfhrohhmpedfnfhutggr shcurfgrrhguuhgvfdcuoehluhgtrghssehluhgtrghsphgrrhguuhgvrdgtohhmqeenuc ggtffrrghtthgvrhhnpeduhfeuieekieeghfevgfevjeefieehgfetledtgeevtedvgeef leffteevffffgeenucffohhmrghinhepqhhuihgtfihgrdhorhhgpdhgihhthhhusgdrtg homhdpghhithhhuhgsrdhiohenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhep mhgrihhlfhhrohhmpehluhgtrghssehluhgtrghsphgrrhguuhgvrdgtohhmpdhnsggprh gtphhtthhopedt
X-ME-Proxy: <xmx:I7SoZo4zDbHm3oU4LucYuRCxAkRIeq8w23MXDON0Tx7nt8OBks6L7A> <xmx:I7SoZp3zuy4Z7qA_PemzZVnm2-VfROOlCZi0BObRilcFKXshF4cRFA> <xmx:I7SoZjGM5bmE-wuOxjZR6WzDUfbx5rVsssYdRtO7i3QUtdb-2YKB8g> <xmx:I7SoZi9Tw54pvwbdFLCzAREraRCDj8tgEUQWF4MQ4vClTetCexcg-Q> <xmx:I7SoZpP1kJZONZC6U4e-48dfVFccgfUUPi4NASkaoIjpDAvW09IQ1rZt>
Feedback-ID: i23b94938:Fastmail
Received: by mailuser.nyi.internal (Postfix, from userid 501) id 9E18519C0079; Tue, 30 Jul 2024 05:36:35 -0400 (EDT)
X-Mailer: MessagingEngine.com Webmail Interface
MIME-Version: 1.0
Date: Tue, 30 Jul 2024 10:36:15 +0100
From: Lucas Pardue <lucas@lucaspardue.com>
To: Ted Hardie <ted.ietf@gmail.com>
Message-Id: <f3c381cc-8603-40f2-958e-333bba8bf1ef@app.fastmail.com>
In-Reply-To: <CA+9kkMDTYeVvkPMHXz7EsNbO1qB0ArYnnFrCxio8X2QJGfjGfA@mail.gmail.com>
References: <24f54137-c806-405d-8e62-235ccaad1b2a@app.fastmail.com> <CA+9kkMDTYeVvkPMHXz7EsNbO1qB0ArYnnFrCxio8X2QJGfjGfA@mail.gmail.com>
Subject: Re: Proposal to migrate from QUIC GitHub wikis to quicwg.org
Content-Type: multipart/alternative; boundary="f27772fb0868404a9acd60d20286010b"
Message-ID-Hash: L7UCPRUYEZD7DYJY4IHWAVNP6YAFHDZP
X-Message-ID-Hash: L7UCPRUYEZD7DYJY4IHWAVNP6YAFHDZP
X-MailFrom: lucas@lucaspardue.com
X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-quic.ietf.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; digests; suspicious-header
CC: quic@ietf.org
X-Mailman-Version: 3.3.9rc4
Precedence: list
List-Id: Main mailing list of the IETF QUIC working group <quic.ietf.org>
Archived-At: <https://mailarchive.ietf.org/arch/msg/quic/WO4gSYLGB7JmcOnS9VNMllBufhg>
List-Archive: <https://mailarchive.ietf.org/arch/browse/quic>
List-Help: <mailto:quic-request@ietf.org?subject=help>
List-Owner: <mailto:quic-owner@ietf.org>
List-Post: <mailto:quic@ietf.org>
List-Subscribe: <mailto:quic-join@ietf.org>
List-Unsubscribe: <mailto:quic-leave@ietf.org>

Hi Ted,

On Tue, Jul 30, 2024, at 10:15, Ted Hardie wrote:
> Hi Lucas,
> 
> I think I am missing something fundamental here:
> 
> I'd like to propose that we migrate away from using GitHub wikis for all repositories in the quicwg org, towards using the quicwg.org pages. This is intended to improve the contribution and change process. It is hoped that this will also improve the discoverability of content on the wiki. During any migration, content will continue to reside on the wiki.
> 
> There is nothing on those pages that I could see that indicates how you can propose a change to the pages.  If the aim here is to enable "useful grass roots contribution and maintenance.", I think it would be appropriate to say more about how this migration does that, because I don't understand it.  The quicwg website doesn't even indicate how to contact the maintainers, so it's hard to see how it enables a grassroots effort.
Indeed, the current quicwg.org has been mostly operated by the chairs, with a small number of contributions from those that might have stumbled on the repo.

Consolidating useful information to a single place would come with improving the documentation on how to contribute, whether it be an issue or a PR to the repo [1]. And of course, we would cover the requisite notes on contribution code of conduct and note well.

Cheers
Lucas

[1] https://github.com/quicwg/quicwg.github.io