whatwg / sg

A place to raise issues with the WHATWG Steering Group
https://whatwg.org/policies
Other
64 stars 39 forks source link

Accommodate multiple Standards per Workstream better #211

Open annevk opened 1 year ago

annevk commented 1 year ago

I noticed a couple issues, both with policy and the way we operate.

https://github.com/whatwg/meta/blob/main/MAINTAINERS.md#review-drafts suggests this line which we use whenever we publish a Review Draft, e.g., https://github.com/whatwg/url/pull/755:

A MONTH YEAR Review Draft (linked) for this Workstream will be published shortly after merging this pull request.

This works for a 1:1 mapping between Standards and Workstreams, but not when there's multiple. I suspect this would need to be something like

A MONTH YEAR Review Draft (linked) of the [X] Standard for the [X] Workstream will be published ...

Perhaps it could be "this Standard" as we can assume people following the repository will know. And the link also makes that clear. The Workstream is not necessarily clear however.


In the Workstream Policy https://whatwg.org/workstream-policy we talk about a "Workstream Repository", but this is not the way the WHATWG operates. We have repositories for Standards. I suggest we pluralize the definition (i.e., allow a Workstream to have multiple repositories) and adjust references to it accordingly.


That also suggest we might want to track repositories that don't host a Standard but do belong to a Workstream. E.g., whatwg/html-build should probably belong to the HTML Workstream. Perhaps this is a thing we should add to db.json?