Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions features/supports-at-rule.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
name: supports-at-rule()
Copy link
Collaborator

Choose a reason for hiding this comment

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

Sorry, I didn't explain myself here very well. The name before was fine with me, it was only the ID/filename that needed to change.

Suggested change
name: supports-at-rule()
name: at-rule()

description: "The `at-rule()` function, when used with `@supports`, checks if a CSS at-rule is supported. For example `@supports at-rule(@starting-style)` checks if the `@starting-style` at-rule is supported."
spec:
https://www.w3.org/TR/css-conditional-5/
https://github.com/w3c/csswg-drafts/pull/12945
https://github.com/MicrosoftEdge/MSEdgeExplainers/blob/main/AtRuleFeatureDetection/explainer.md
Comment on lines +4 to +6
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 the one who asked Diego to add all 3 URLs here, but we should choose one. @ddbeck do you think it's better to link to the spec (even if doesn't have the changes for this feature in it yet), the PR that's making the changes, or the explainer?

Copy link
Contributor

Choose a reason for hiding this comment

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

Looking at other features, it seems like we could choose between pointing to the explainer or the PR. I would vote for the PR because this way it's easy to later check if the PR has been merged, and update the link to the proper spec.
If we link to the explainer, it's maybe more useful for developers, but there's no easy sign to know that an explainer has graduated to a spec, and which one.

So let's perhaps use the PR URL only.

But, also, the build will fail if we do this. To make the build happy, please also add the PR URL to the defaultAllowlist array in /scripts/specs.ts, with a reason why the PR is allowed (e.g. because that's the closest thing we have to a spec).

Copy link
Collaborator

Choose a reason for hiding this comment

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

Of the 3 links suggested, I think we should only link the w3c/csswg-drafts#12945. That's something that a script can look at and determine when the PR is merged and the spec URL can be updated.

@ddbeck has proposed that we should use proposal instead of spec for this situation, and that would avoid the defaultAllowlist problem.

Copy link
Collaborator

@ddbeck ddbeck Oct 16, 2025

Choose a reason for hiding this comment

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

Yes, I like the idea of linking to, in order of preference:

  1. An actual spec known to browser-specs
  2. A PR against an actual spec known to browser-specs
  3. Any other PR
  4. Any other URL

#2647 exists to track this idea though it doesn't mention the proposal behavior. I'll put a comment there file a new issue. (edit: no it doesn't, wrong thing)

Copy link
Collaborator

Choose a reason for hiding this comment

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

I created #3470

group: css
6 changes: 6 additions & 0 deletions features/supports-at-rule.yml.dist
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Generated from: supports-at-rule.yml
# Do not edit this file by hand. Edit the source file instead!

status:
baseline: false
support: {}