Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/WICG/proposals

A home for well-formed proposed incubations for the web platform. All proposals welcome.
https://github.com/WICG/proposals

incubation proposals wicg-proposals

Last synced: about 1 month ago
JSON representation

A home for well-formed proposed incubations for the web platform. All proposals welcome.

Awesome Lists containing this project

README

        

# ![WICG Logo](https://avatars1.githubusercontent.com/u/13145324?s=100)

# Welcome to the WICG Proposals Repo!

This is the WICG proposals repo, a place for ideas to start their incubation
journey. Plan to use this repo's [issue tracker](https://github.com/WICG/proposals/issues)
for submitting and discussing new proposals much like the now archived
[Discourse threads](https://discourse.wicg.io/) were used previously.

Please note that all proposals in this repo (including those in separate markdown documents)
have no official status in the WICG as incubations.

## 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."

Instead, 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...
> ``"

## Proposals in issues vs. separate markdown documents?

If you would like to make a 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 are 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.

## Getting Started

Is your proposal unique? Head over to the [issues list](https://github.com/WICG/proposals/issues)
and search for it; if it was suggested by someone else give it your support with a πŸ‘ or leave a
comment. If you don't find anything there, consider starting a new issue. (You are also welcome
to visit [Discourse](https://discourse.wicg.io/) and search there as well, especially while this
repo is first getting populated).

## Search proposals by category

The proposals are grouped by category (as discussions are on Discourse):

| Label | Short description | Discourse category |
|-------|-------------------|--------------------|
| **[APIs](https://github.com/WICG/proposals/labels/Category%3A%20APIs)** | All proposals about JS APIs. | [APIs](https://discourse.wicg.io/c/apis/6) |
| **[HTML](https://github.com/WICG/proposals/labels/Category%3A%20HTML)** | HTML-related proposals (not only the HTML standard but any markup-related ideas). | [HTML](https://discourse.wicg.io/c/html/10) |
| **[CSS](https://github.com/WICG/proposals/labels/Category%3A%20CSS)** | CSS-related proposals. | [CSS](https://discourse.wicg.io/c/css/8) |
| **[Uncategorized](https://github.com/WICG/proposals/labels/Category%3A%20Uncategorized)** | Proposals that don't fit into any other existing category. | [Uncategorized](https://discourse.wicg.io/c/uncategorized/1) |
| **[Meta](https://github.com/WICG/proposals/labels/Category%3A%20meta)** | Proposals/ideas/discussions about this proposals repo, its organization, how it works, and how we can improve it. | [meta](https://discourse.wicg.io/c/meta/3) |
| **[JS](https://github.com/WICG/proposals/labels/Category%3A%20JS)** | JS language proposals. | [JS](https://discourse.wicg.io/c/js/18) |
| **[Security](https://github.com/WICG/proposals/labels/Category%3A%20Security)** | Proposals with a focus on web security, client-side protections, improved site security, etc. | [Security](https://discourse.wicg.io/c/security/21) |
| **[Protocols](https://github.com/WICG/proposals/labels/Category%3A%20protocols)** | Proposals for anything relating to protocols such as HTTP, Web Sockets, & JSON-based protocols. | [protocols](https://discourse.wicg.io/c/protocols/14) |
| **[WASM](https://github.com/WICG/proposals/labels/Category%3A%20WASM)** | Proposals for the WebAssembly language. Also consider reviewing [the WebAssembly Community Group's issue tracker](https://github.com/webassembly/spec/issues). | [asm.js](https://discourse.wicg.io/c/asm-js/16) |
| **[Architecture](https://github.com/WICG/proposals/labels/Category%3A%20Architecture)** | For proposals related to web architecture or architectural components. | [Architecture](https://discourse.wicg.io/c/architecture/13) |
| **[Media & RTC](https://github.com/WICG/proposals/labels/Category%3A%20Media%20%26%20RTC)** | For Media (video/audio) and Real-Time Communications proposals. | [Media and Real-Time Communications](https://discourse.wicg.io/c/mediartc/20) |
| **[Web Components](https://github.com/WICG/proposals/labels/Category%3A%20Web%20Components)** | Proposals for web components. Also consider reviewing [the webcomponents incubation issue tracker](https://github.com/w3c/webcomponents/issues) | [Web Components](https://discourse.wicg.io/c/web-components/9) |
| **[Web Apps](https://github.com/WICG/proposals/labels/Category%3A%20Web%20Apps)** | Proposals related to bringing App-like behavior to the web | n/a |

## Evolving from Discourse

Previously, we used [Discourse discussions](https://discourse.wicg.io/) 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 this dedicated home for future incubations to
be proposed that is distinct from other ideas, explorations, and discussions about the web
platform.

This proposals repo will meet these changing needs. Here in GitHub you can 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 ideas should be filed as issues here in
this 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](https://github.com/WICG/admin/blob/gh-pages/README.md).