Skip to content

Commit 3c1addc

Browse files
fooliprachelandrewzcorpan
authored
Document the Interop 2023 proposals process for the public (#115)
Co-authored-by: Rachel Andrew <[email protected]> Co-authored-by: Simon Pieters <[email protected]>
1 parent 87f2a45 commit 3c1addc

File tree

6 files changed

+96
-72
lines changed

6 files changed

+96
-72
lines changed

.github/ISSUE_TEMPLATE/compat-bug-proposal.md

Lines changed: 0 additions & 22 deletions
This file was deleted.

.github/ISSUE_TEMPLATE/other.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
---
22
name: Other
3-
about: Any issue that isn't a proposal to include in Interop 2022
3+
about: Any issue that isn't a proposal to include in Interop 2023
44
title: ''
55
labels: ''
66
assignees: ''

.github/ISSUE_TEMPLATE/proposal.md

Lines changed: 0 additions & 20 deletions
This file was deleted.

.github/ISSUE_TEMPLATE/proposal.yml

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
name: Proposal
2+
description: Proposal for feature to include in Interop 2023
3+
labels: proposal
4+
body:
5+
- type: markdown
6+
attributes:
7+
value: |
8+
**Interop 2023 has not yet launched and this documentation is still being finalized. Please do not submit proposals yet.**
9+
10+
Thanks for taking the time to make a proposal for Interop 2023!
11+
12+
Please see the [Interop 2023 README](https://github.com/web-platform-tests/interop/blob/main/2023/README.md) for the timeline and what to expect from the process.
13+
- type: textarea
14+
attributes:
15+
label: Description
16+
description: Brief description of the feature. Try to be clear about what parts of the feature are included and not.
17+
- type: textarea
18+
attributes:
19+
label: Specification
20+
description: |
21+
Specification for the feature. The feature should be defined by a standards-track specification from the following organizations:
22+
23+
- [IETF](https://www.ietf.org/) (Standard Track)
24+
- [Khronos Group](https://www.khronos.org/)
25+
- [TC39](https://tc39.es/) (Stage 2+)
26+
- [W3C](https://www.w3.org/) (Recommendation Track)
27+
- [WHATWG](https://whatwg.org/)
28+
- type: textarea
29+
attributes:
30+
label: Tests
31+
description: Tests for the feature in web-platform-tests on [wpt.fyi](https://wpt.fyi/), or in Test262 on [test262.report](https://test262.report/).
32+
- type: textarea
33+
attributes:
34+
label: Rationale
35+
description: |
36+
Reasons for including the feature. A few dimensions to consider are:
37+
38+
- Web developer sentiment from polls or surveys, for example, [MDN surveys](https://insights.developer.mozilla.org/) or [State of CSS](https://stateofcss.com/).
39+
- Examples of sites or libraries working around a missing feature or browser bug.
40+
- Browser bugs or browser bug statistics, for example, [Chromium](https://bugs.chromium.org/), [Gecko](https://bugzilla.mozilla.org/), or [WebKit](https://bugs.webkit.org/).
41+
- Current usage of the feature, for example, [Chrome use counters](https://www.chromestatus.com/metrics/feature/popularity) or [HTTP Archive](https://httparchive.org/).

2023/README.md

Lines changed: 51 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,51 @@
1+
# Interop 2023
2+
3+
**Interop 2023 has not yet launched and this documentation is still being finalized. Please do not submit proposals yet.**
4+
5+
Interop 2023 aims to make the web more interoperable in key areas, prioritized by web developer and user needs. The team is formed of browser vendors and other contributors to the web platform, and is part of [the web-platform-tests project](https://github.com/web-platform-tests/wpt).
6+
7+
Similar to [Interop 2022](https://wpt.fyi/interop-2022), this will be a public metric based on the progress of selected focus areas and investigation efforts. The overall timeline for the planning process is:
8+
9+
- Public call for proposals beginning September 15.
10+
- Proposal review by the team, with an opportunity for refinement.
11+
- Selection of proposals by the team, based on consensus.
12+
- Public launch in early 2023.
13+
14+
If you would like to make a proposal or contribute in other ways, read on.
15+
16+
## Making a proposal
17+
18+
**Interop 2023 has not yet launched and this documentation is still being finalized. Please do not submit proposals yet.**
19+
20+
If you've had problems using a feature on the web because of differences between browsers, or because it isn't implemented in all browsers, it may be a good proposal for Interop 2023!
21+
22+
Before making a proposal, here's what to expect:
23+
24+
- Only features which have high quality specifications and tests are in scope. Interop 2023 is not a venue for specifying new features; that work happens in working groups within organizations such as W3C and WHATWG.
25+
- Interop 2023 is not a process for making browser vendors work on things they're opposed to. Decisions are made by consensus, so highly contentious features are unlikely to be accepted.
26+
- Even great proposals may ultimately not be accepted, since we have to prioritize.
27+
28+
The process for making and driving a proposal is:
29+
30+
- **September 15 to October 15**: [File a proposal issue](https://github.com/web-platform-tests/interop/issues/new?labels=proposal&template=proposal.yml) and fill in as many details as you can.
31+
- **October 16 to October 30**: The Interop team review and discuss proposals. During this time some refinements to the proposal can still be made. After this point no further action is required, but continued participation is certainly welcome, particularly to answer any questions.
32+
- **November 1 to November 30**: The Interop team decide, by consensus, which proposals to accept. Accepted proposals will require a pull request to document the accepted proposal in the repository. Help with this is appreciated, but not required.
33+
34+
## After a proposal is accepted
35+
36+
The Interop team is responsible for driving everything after a proposal is accepted. Here's what to expect:
37+
38+
- **December 1 to December 16**: Detailed review of the tests, and possibly writing some additional tests. Creation of a public dashboard showing the accepted proposals.
39+
- **January 9 to January 20**:
40+
- Finalize test selection.
41+
- Complete announcement plans. Prepare dashboard for launch.
42+
- **January 23 to January 27**: Public launch.
43+
- **Throughout 2023**: Track progress on the public dashboard. If issues with the test suite are found, anyone can make [test change proposals](https://github.com/web-platform-tests/interop/issues/new?assignees=&labels=test-change-proposal&template=test-change-proposal.md), for review by the Interop team. Significant changes to the scope are unlikely to be accepted.
44+
45+
Ultimately, the outcome we hope for is that interoperability significantly improves, and that web developers and users benefit.
46+
47+
## Other ways to contribute
48+
49+
TODO
50+
51+
You're also welcome to join the conversation in the [`#interop20xx:matrix.org` Matrix channel](https://app.element.io/#/room/#interop2022:matrix.org)!

README.md

Lines changed: 3 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -1,31 +1,5 @@
1-
# Interop 2022
1+
# The Interop Project
22

3-
This repository is for discussing proposals relating to the Interop
4-
2022 project.
3+
Welcome to the Interop project, an ongoing effort to make the web more interoperable in key areas, prioritized by web developer and user needs. This is part of [the web-platform-tests project](https://github.com/web-platform-tests/wpt), the main test suite for the web platform.
54

6-
The overall process and timeline for decision making is given by [wpt
7-
RFC 99](https://github.com/web-platform-tests/rfcs/blob/master/rfcs/interop_2022.md).
8-
9-
For each proposed Interop 2022 focus area:
10-
* First check for an existing issue covering that area. We are aiming
11-
to consolidate discssion for each proposal in a single issue.
12-
13-
* If no issue exists, file a new issue. The issue title should
14-
clearly describe the feature being proposed for inclusion. The body
15-
of the issue should outline the reason for including the issue and should include:
16-
17-
- A link to the relevant specification document
18-
19-
- A link to relevant testcases (assuming they exist)
20-
21-
- Supporting data for including the feature as part of an interop
22-
effort e.g. evidence of significant developer interest in the
23-
feature, or evidence of site breakage caused by implementation
24-
differences in the feature.
25-
26-
- Links to any existing discussion or vendor signals e.g. in browser
27-
project bug trackers.
28-
29-
## Join the discussion
30-
31-
* [Real-time chat room](https://app.element.io/#/room/#interop2022:matrix.org): the `#interop2022:matrix.org` Matrix channel
5+
**We are currently planning for Interop 2023 and welcome participation from anyone working on the web, please see the [Interop 2023 README](./2023/README.md) to learn more!**.

0 commit comments

Comments
 (0)