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

[Will Hawkins <[e-mail]>]

On Sun, Jul 28, 2024 at 12:24 AM Lucas Pardue <[e-mail]> wrote:
>
> Hi folks,
>
> During the standardisation of QUIC, we made a lot of use of GitHub's wiki capabilities in the primary base-drafts repo that housed all drafts at that time [1]. This was a community effort. Everyone had write access and the wiki tracked the leading edge of development closely.
>
> Since the RFCs were published things have matured and stabilised. We've seen several new documents get adopted and worked on in their own repos. Yet the base-draft remained the spiritual centre of wiki, especially when it came to listing implementations or tools. Even if they weren't updated as frequently.
>
> Unfortunately, last year the wiki was vandalised and needed restoration. At the same time, to prevent further vandalism, we restricted access to wiki edits to GitHub accounts that had certain repo privileges. However, that's had the unfortunate effect of preventing useful grass roots contribution and maintenance. Further investigation into this area has indicated to me that the GitHub access control approach and UI for wikis is not suited to our regular ways of working: issues and pull requests from anyone, merges by authorised users only.
>
> The quicwg.org homepage is intended to be an easy-to-use hub for the QUIC WG. It's also powered by GitHub [2]. It links off to the wiki for some, but not all, content there.
>
> 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.
>
> I've already floated the idea in the QUIC slack, and the general sentiment is in support of doing the migration. So I'm opening up the proposal to a broader participant list. I'm especially interested if you have objections, or if you have thought or ideas about how best to migrate and present the content (especially if you'd like to volunteer on UI design or other related matters).

I believe that my attempt at contributing a minor typo fix was the
impetus for this email. Thank you for taking my attempt to "add value"
so seriously. Because I had a hand in bringing this issue to a head, I
wanted to

1. Nod in support of a migration, and
2. Offer to help with the technical aspects of the migration.

Please let me know if/how I can help!

Thank you, again, for bringing this discussion into the open!

Sincerely,
Will


>
> Cheers
> Lucas
>
>
> [1] https://github.com/quicwg/base-drafts/wiki
> [2] https://github.com/quicwg/quicwg.github.io
>