Skip to content

Latest commit

 

History

History
207 lines (144 loc) · 7.65 KB

File metadata and controls

207 lines (144 loc) · 7.65 KB

Interop Proposers Guide

As set out in the README, the goal of the Interop project is to improve the web by making it easier to create websites and webapps that work well in every browser and browser engine.

This guide lists the signals that the Interop team uses when selecting focus areas, in order to help you understand what is likely to be accepted, and help you advocate for your proposal in the most effective way.

Note that apart from those under Essential Criteria, none of the items listed are considered binding, and the different organizations that are part of the Interop team may use the criteria in different ways, or supplement these with their own specific considerations.

For reference, here are some proposals from past years that are well structured. Please note that the proposal template will have changes year over year. We encourage you to read the guide in its entirety for the latest guidance.

Example proposals

Submitting a proposal

Submit a proposal using one of the following links:

To give your proposal the best chance of success, see the essential criteria below.

If you want to propose a new feature for the web platform, please file an issue with the relevant group, such as the CSSWG for CSS features.

Essential Criteria

Testing

Interop focus areas are scored by the pass rate of tests from the Web Platform Tests project (WPT). This means that, to be accepted:

  • The proposed feature must be covered by web-platform-tests.

  • The test coverage must be sufficient to represent a meaningful assessment of implementation quality and interoperability.

  • Tests must be fully automated and included in Chrome, Edge, Firefox and Safari desktop runs on wpt.fyi.

If the feature you are proposing has insufficient test coverage during the proposal period, you can provide an indication of how you expect to achieve the necessary test coverage before the final focus areas are picked. The Interop team will judge how credible it considers these plans to be, and may choose to focus on proposals where tests are already available.

Ongoing Standards Work

Interop is not a venue for performing standards work. Proposals which are not backed by an existing standard in a recognized standards venue are highly unlikely to be accepted.

Proposals may cover areas which still have some unresolved standards questions. In these cases it's likely that one of the following will be required:

  • The areas of ongoing discussion are explicitly excluded from the focus area.

  • The areas of ongoing discussion are understood to be highly significant in terms of interoperability, have tentative tests, and the Interop team agrees that reaching resolution on the outstanding questions is possible either before the Interop period starts or early in the Interop period.

Additional Signals

Web Features

In some cases proposals may correspond to a specific web-feature. In these cases providing the web-feature id in the proposal will allow information about the feature, such as relevant standards positions, to be gathered and filled in automatically.

Standards Positions

Interop is not intended as a venue to reach agreement on whether a feature is suitable for the web platform.

Proposals covering features where individual participating organizations on the Interop team have already indicated significant concerns, for example through standards-position repositories or similar public venues, are highly unlikely to be accepted. You may of course work with these organizations to address their existing concerns before making an Interop proposal.

Site Breakage and Workaround

This includes any evidence of interoperability problems affecting web developers today, for example:

  • Sites that are broken in some browsers due to interoperability problems.

  • Evidence of sites or libraries needing to work around the browser differences in order to function correctly across multiple browsers.

Size and Current State of the Feature

Whether or not the feature is already widely implemented, and the confidence you have on full implementation being achievable:

  • Features that are already widely implemented but have behavior differences may be considered more pressing than implementing new functionality.

  • Features that are already present in multiple browser engines may be a higher priority than recently standardized features that are not yet implemented.

  • Use counter data, such as feature usage telemetry tracked by browsers, might be considered, if it's showing a clear trend and can be cleanly attributed to a real increase in use of the feature. Past experience shows that absolute numbers in use counter data can be misleading, so this is unlikely to carry much weight on its own.

Browser Bugs

Any evidence of developer demand in public bug trackers. For example:

Developer Surveys

Surveys indicating the degree of developer interest in a specific feature, or highlighting problems that the proposal is likely to address. For example:

Participating organizations may also look at their internal research to understand developer sentiment around a feature.

Other Developer Sentiment

For example:

  • Posts on sites like Stack Overflow asking about a feature, or trying to work around a missing feature or browser difference.

  • Blog posts explaining how a feature addresses important problems.

Likely Compatibility Impact

Whether the proposal covers a feature where browser differences are likely to cause observable breakage:

  • Whether the feature is easy to poly-fill accurately and with minimal performance impact.

  • How likely users are to notice the absence of the feature (for example features that add new layout models compared to features that enable more subtle visual improvements).

  • Whether the feature is a prerequisite to other features that themselves are expected to have high impact on users or developers.

Platform Impact

Whether the proposal is likely to have a positive impact on participating organizations' values for the web platform, for example:

  • Accessibility

  • Internationalization

  • Privacy

  • Security

Overall Project Balance

Interop is intended to cover the entire web platform. Therefore the assessment of proposals may also take into account what else has been proposed, in order to ensure that the project is driving improvements to many different areas of the platform.