Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document the Interop 2023 proposals process for the public #115

Merged
merged 15 commits into from
Sep 9, 2022
Merged

Conversation

foolip
Copy link
Member

@foolip foolip commented Aug 24, 2022

No description provided.

Copy link
Contributor

@rachelandrew rachelandrew left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a bit of copy editing.

@foolip
Copy link
Member Author

foolip commented Aug 24, 2022

Thanks for the edits @rachelandrew, much nicer now :)

@foolip foolip mentioned this pull request Aug 24, 2022
This was referenced Aug 31, 2022
@@ -0,0 +1,31 @@
name: Proposal
description: Proposal for feature to include in Interop 2023
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wonder if it makes sense to have a separate issue template for investigation proposals, asking for more things like "what is the proposed outcome of this investigation effort, what is being investigated, etc"

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes, we should do that!

Copy link

@karlcow karlcow left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks very good to me.

@@ -0,0 +1,40 @@
name: Proposal
description: Proposal for feature to include in Interop 2023
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We usually use the term "focus area" rather than "feature". I notice that you're using "feature" all the way through here, and I guess a 1:1 mapping is the commonest case, but it's not the general case e.g. webcompat isn't a single feature, and the "Typography and Encodings" focus area from last year wasn't a single feature (although that was a later merge of several proposals).

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I didn't make a conscious decision on this, but overall tried to use wording that'd be easier to parse for web developers, written more from the outside than the inside perspective.

I don't have a strong opinion on this one, but do you think it'd be fine to talk about feature (singular) and just let people propose things that aren't strictly a single feature anyway? Or maybe we talk about "feature or group of features"? I think "focus area" might require explanation to be understood.


- 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.
- 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.
- Even great proposals may ultimately not be accepted, since we have to prioritize.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm not sure this bullet is adding much value, but it does feel like it's adding a lot of stop energy. Maybe it would sound less negative to fold it into the previous bullet point and added some positive advice: ", so highly contentious features are unlikely to be accepted, and vendors will also consider the priority of proposals against other possible work. Proposals accompanied by strong rationale (e.g. evidence of problems affecting real sites, or significant developer interest) are more likely to succeed."

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I'm fine with whatever wording others are happy with here. The purpose of this was to avoid disappointment if we end up not accepting some good proposals from "external" contributors who put in a lot of work.

Copy link
Member

@tantek tantek left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks good enough to land and keep iterating, with the inclusion of an explicit warning at the top of the README that it has not yet been finalized and we expect more iteration. Actual wording up to @foolip per @chrishtr suggestions on today's call.

- [W3C](https://www.w3.org/) (Recommendation Track)
- [WHATWG](https://whatwg.org/)

Other specifications will be considered on a case-by-case basis.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Per meeting discussions, remove this since anyone who might have a proposal that requires the exception, and which has a reasonable chance of being accpeted, is probably close enough to the project that they know why the other rules don't apply in this specific case.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Will remove!

@foolip
Copy link
Member Author

foolip commented Sep 9, 2022

Based on the "Could we land this PR with a note to say it's not totally finalised?" comment in #128 (comment) I'm going to add this disclaimer to README and issue template:

Interop 2023 has not yet launched and this documentation is still being finalized. Please do not submit proposals yet.

@foolip foolip merged commit 3c1addc into main Sep 9, 2022
@foolip foolip deleted the public-docs branch September 9, 2022 20:10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

8 participants