Introducing a new home for proposals

Hello WICG!

Today we are introducing a wicg/proposals repo [1]<https://nam06.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FWICG%2Fproposals&data=02%7C01%7CTravis.Leithead%40microsoft.com%7Cf228331304454b5ccf3c08d84c606e8b%7C72f988bf86f141af91ab2d7cd011db47%7C0%7C0%7C637343325242606549&sdata=FE8rZNB6EEbM8W6b23Q5XBN9%2FUQNMqaZEKZJrUOqWIw%3D&reserved=0>, a place for well-formed ideas to start their incubation journey. Plan to use the proposals repo issue tracker [3]<https://nam06.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FWICG%2Fproposals%2Fissues&data=02%7C01%7CTravis.Leithead%40microsoft.com%7Cf228331304454b5ccf3c08d84c606e8b%7C72f988bf86f141af91ab2d7cd011db47%7C0%7C0%7C637343325242606549&sdata=wDscn30UpjQ4%2Fcbzya96jmmUPJjL%2F1%2F8%2BHOJwgSdBmA%3D&reserved=0> for submitting and discussing new proposals much like Discourse threads [2]<https://nam06.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdiscourse.wicg.io%2F&data=02%7C01%7CTravis.Leithead%40microsoft.com%7Cf228331304454b5ccf3c08d84c606e8b%7C72f988bf86f141af91ab2d7cd011db47%7C0%7C0%7C637343325242616498&sdata=RcEFXyGQQ8rV2%2F5oWUtP%2FFUXDyt8mz29Z2tWqmXJGNY%3D&reserved=0> were used previously. Discourse will remain a good home for less well-formed ideas to germinate, for early explorations, and for other discussions. But if you have a well-formed idea, you may skip Discourse and start an issue in the proposals repo. Think of Discourse and the proposals repo as two potential destinations for new WICG ideas, the former for earlier, less-well-formed concepts, and the later for more crystalized proposals. We're learning as we go, so please pardon any rough edges as we continue to streamline our process. More details below. 👇

-Travis Leithead on behalf of the WICG chairs

--

Previously, the WICG used Discourse discussions [2]<https://nam06.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdiscourse.wicg.io%2F&data=02%7C01%7CTravis.Leithead%40microsoft.com%7Cf228331304454b5ccf3c08d84c606e8b%7C72f988bf86f141af91ab2d7cd011db47%7C0%7C0%7C637343325242616498&sdata=RcEFXyGQQ8rV2%2F5oWUtP%2FFUXDyt8mz29Z2tWqmXJGNY%3D&reserved=0> for anything that wasn't an official incubation (i.e., an incubation with its own repo). That forum was host to all discussions, early explorations, suggestions, and proposals for the web platform. The goal was to help establish our community where those who participated in developing web standards and those who didn't have the time but still wanted to influence/advance the web could mingle and share ideas. In short, bringing together the broadest possible community of interested developers to give and receive feedback. Our goal was largely successful.

As time passed, the developer ecosystem shifted. We now see that GitHub has a larger community of web developer interest than ever before, is the primary host of specification development for major web standards organizations and has great tools and integration for project and issue management. We also see an opportunity to provide more direct guidance on how to start an incubation, by creating a dedicated home for such future incubations to be proposed that is distinct from other ideas, explorations, and discussions about the web platform.

We're now introducing a proposals repo [1]<https://nam06.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FWICG%2Fproposals&data=02%7C01%7CTravis.Leithead%40microsoft.com%7Cf228331304454b5ccf3c08d84c606e8b%7C72f988bf86f141af91ab2d7cd011db47%7C0%7C0%7C637343325242616498&sdata=IohnoNlgl8bxHE6UwUiW6ADW2%2F8lTxRFD3OLShJytW8%3D&reserved=0> to meet these changing needs. The proposals repo is hosted in GitHub allowing you to easily extend your existing repo and issue monitoring techniques to keep track of what's being proposed. Additionally, this gives us a chance to clarify the WICG process for starting new incubations: rather than ask that proposals for new incubations be started on Discourse (intermingled with all other Discourse conversations), instead well-formed ideas should be filed as issues in the proposals repo, making it clear that these proposal issues intend to begin life as an incubation. Our expectations for evaluation of new proposals remains the same: as soon as sufficient interest is shown in the proposal's issue thread (notably from potential implementers), the WICG chairs will enable a team of editors to manage the proposal, and those team members can begin work in a new repo or move ownership of an existing GitHub repo to WICG. For more information about the evaluation and incubation process, see the admin repo's README file [4]<https://nam06.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FWICG%2Fadmin%2Fblob%2Fgh-pages%2FREADME.md&data=02%7C01%7CTravis.Leithead%40microsoft.com%7Cf228331304454b5ccf3c08d84c606e8b%7C72f988bf86f141af91ab2d7cd011db47%7C0%7C0%7C637343325242626463&sdata=SVcdcwTOzU%2BffAvJj3xc2BnNDeBrermt%2BV1fQetJOP8%3D&reserved=0>.

We continue to recommend that our community participate in Discourse for less well-formed ideas to germinate, for early explorations, and for other discussions. As these ideas, explorations, and discussions mature, they may form into a proposal which should then be filed as an issue in the proposals repo.

What does a proposal look like?

A proposal outlines a particular problem or challenge on the web and offers a potential concrete solution. Without being too prescriptive, you know you've got a proposal when you can articulate a specific way (procedurally, algorithmically, declaratively) that a new or current web technology solves an existing problem or challenge. If the problem is unclear, or the potential solution is too abstract you're not quite there yet.

For example, this is not a proposal: "Websites have lots of bugs because they don't get updated or because browsers change their behavior over time. There should be a universal way for users to report bugs to websites so that they get fixed."

A proposal might be: "Websites have lots of bugs because they don't get updated or because browsers change their behavior over time. One way to solve this is to create an experience in the browser that allows users to record a set of steps that reproduce the problem, and then standardize the format for these replay instructions, and provide an API to allow sites to capture this feedback or an HTTP header to post this feedback back to their site. Below I describe the proposed format and API... <snip>"

Proposals in issues vs separate markdown documents?

If you would like to make the proposal as a separate markdown document (if for example, it was developed in a separate repo) you are welcome to link to it from the proposal issue; just provide a bit of high-level context on the problem and proposed solution in the issue as well. Alternatively, if you'd like to use the proposal repository itself to host a separate markdown document, you're welcome to submit a PR for it--we still ask that you file an issue to track your proposal and provide context as previously mentioned. This will make it easier for our entire community to use the issue tracker to search through all proposals.

[1] https://github.com/WICG/proposals<https://nam06.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FWICG%2Fproposals&data=02%7C01%7CTravis.Leithead%40microsoft.com%7Cf228331304454b5ccf3c08d84c606e8b%7C72f988bf86f141af91ab2d7cd011db47%7C0%7C0%7C637343325242626463&sdata=or18yf02f%2BnN03k0cPIyS%2FOwBuahFJM1IhwLW%2BzWrpQ%3D&reserved=0>
[2] https://discourse.wicg.io/<https://nam06.safelinks.protection.outlook.com/?url=https%3A%2F%2Fdiscourse.wicg.io%2F&data=02%7C01%7CTravis.Leithead%40microsoft.com%7Cf228331304454b5ccf3c08d84c606e8b%7C72f988bf86f141af91ab2d7cd011db47%7C0%7C0%7C637343325242636417&sdata=qyBa2t2RvHz%2BiCmPxHy9HNYfwQnJp84mquOMhDgPbMs%3D&reserved=0>
[3] https://github.com/WICG/proposals/issues<https://nam06.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FWICG%2Fproposals%2Fissues&data=02%7C01%7CTravis.Leithead%40microsoft.com%7Cf228331304454b5ccf3c08d84c606e8b%7C72f988bf86f141af91ab2d7cd011db47%7C0%7C0%7C637343325242636417&sdata=3NLpHy7E1ae7zElJ0pK16VY0HcHituP7aE7Xhmzmt9M%3D&reserved=0>
[4] https://github.com/WICG/admin/blob/gh-pages/README.md<https://nam06.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2FWICG%2Fadmin%2Fblob%2Fgh-pages%2FREADME.md&data=02%7C01%7CTravis.Leithead%40microsoft.com%7Cf228331304454b5ccf3c08d84c606e8b%7C72f988bf86f141af91ab2d7cd011db47%7C0%7C0%7C637343325242646365&sdata=sbwSbKDHieqRZEP2cyk%2BqIIuey%2FZuaq%2FdYteS4Vq5x4%3D&reserved=0>

Received on Wednesday, 2 September 2020 00:54:22 UTC