Skip to content

Convert the specification for publication by the WHATWG - #236

Open
reillyeon wants to merge 9 commits into
mainfrom
convert_to_bikeshed
Open

reillyeon wants to merge 9 commits into
mainfrom
convert_to_bikeshed

Conversation

@reillyeon

Copy link
Copy Markdown
Collaborator

This PR is an automated rewrite of the original specification from ReSpec to Bikeshed which has been manually checked against the original and then had the metadata updated to convert it from a W3C WICG draft report to a WHATWG Living Standard.

This conversion was done automatically and the output manually checked
against the original ReSpec version.
Some editorial changes are necessary to comply with the different
linting rules.
@reillyeon
reillyeon requested a review from annevk October 3, 2026 01:34
@reillyeon

Copy link
Copy Markdown
Collaborator Author

@annevk, since the rewrite is mostly mechanical what I'm looking for here is that I got all the metadata and build tooling set up correctly for a WHATWG spec.

Comment thread index.bs Outdated
Comment thread index.bs Outdated
Comment thread index.bs Outdated
Comment thread index.bs
understand the ways in which granting access to a device breaks traditional
isolation boundaries in the web security model. Security UI and documentation
should explain that granting a site access to a device could give the site full
control over the device and any data contained within.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I don't immediately see the Acknowledgments and IPR sections are specifications have. Again I recommend looking at whatwg/dom and whatwg/infra for copypasta.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

I've added an Acknowledgements section based on what I've seen in other specs and the IPR section seems to have magically appeared. Is there any tooling to keep this updated like how ReSpec could pull automatically from the Git commit history?

@annevk

annevk commented Oct 3, 2026 •

Copy link
Copy Markdown
Member

It seems this is missing many support files. I don't think you have run https://github.com/whatwg/spec-factory, is that right?

Some of this is documented at https://github.com/whatwg/meta/blob/main/NEW-STANDARD.md but it could be more detailed.

@reillyeon

Copy link
Copy Markdown
Collaborator Author

It seems this is missing many support files. I don't think you have run https://github.com/whatwg/spec-factory, is that right?

Thanks, I noticed spec-factory but misinterpreted it as part of the build and deploy pipeline rather than how the repositories themselves were created.

Some of this is documented at https://github.com/whatwg/meta/blob/main/NEW-STANDARD.md but it could be more detailed.

Thanks, I was looking for that checklist last week because I'd seen it before but forgot where.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

2 participants