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

[cssom] Merge Constructable Stylesheets spec into CSSOM spec #3433

Open
rakina opened this issue Dec 12, 2018 · 11 comments

Comments

@rakina
Copy link

commented Dec 12, 2018

The draft spec for Constructable Stylesheets has gotten pretty stable now (just need WICG/construct-stylesheets#69 to land, probably around this week), and we're interested in merging it into the CSSOM specs. @emilio as editor, does this sound good to you? I'll make a PR if it's OK.

Also cc @domenic @tabatkins

@astearns

This comment has been minimized.

Copy link
Member

commented Dec 12, 2018

I assume this should be in a next-level draft of CSSOM (so we could finish the current level before adding new features). The PR would then just be a diff spec added to the directory.

@emilio

This comment has been minimized.

Copy link
Collaborator

commented Dec 14, 2018

I see no problem merging it in CSSOM.

Are you or any other Googler interested in maintaining it? Not a great deal but it'd be good to have some of you on the loop, at least as long as Blink is the only implementation.

I'm not familiar of the process to follow here regarding spec levels and such, but @astearns suggestion sounds reasonable to me.

@tabatkins

This comment has been minimized.

Copy link
Member

commented Dec 14, 2018

Post-merging I'm happy to do continuing maintenance as necessary if @rakina isn't around.

For spec levels, the concern is just that adding new things to an otherwise-stable document reduces our ability to advance it. If the document isn't already in or near an advanceable state, tho, then it doesn't matter and we can just put the new thing in.

@astearns

This comment has been minimized.

Copy link
Member

commented Dec 14, 2018

CSSOM has been around long enough that I'd like to get SOME level of it to REC. Starting a new level with this new feature would allow us to move anything else that isn't yet stable to the new level and get the current draft into a state where we could advance it.

@rakina

This comment has been minimized.

Copy link
Author

commented Dec 17, 2018

It looks like CSSOM is currently Level 1, so this should be in Level 2 of CSSOM? Is there anything else currently on that level?

@astearns

This comment has been minimized.

Copy link
Member

commented Dec 17, 2018

There is nothing else in level 2 yet, so it would be a new draft in a new folder with just this new feature (and an issue noting that it's a diff spec that will eventually have all of the level 1 content added). See Grid level 2 as an example of how you'd set up the draft.

@domenic

This comment has been minimized.

Copy link
Collaborator

commented Dec 17, 2018

Note that it's not very straightforward to have a diff spec here since most methods and properties of CSSStyleSheet are modified. Our motivation for merging, instead of maintaining a separate spec, was specifically to have a single specification with all the algorithms in one place, instead of two like we have currently. Having two (cssom-1 + cssom-2) is not an upgrade over our current two (cssom + constructable stylesheets).

Would it be acceptable for us to work on a single document editors' draft, which can be referenced for implementers looking to get a holistic idea of what to implement? Of course the chairs/editors are welcome to carve that up into separate specs for W3C process purposes if they'd like.

@astearns

This comment has been minimized.

Copy link
Member

commented Dec 17, 2018

It isn't a requirement to make the next-level spec a diff spec. That's done mainly for editor convenience. It's perfectly fine to copy all of level 1 into the level 2 doc (updating the cssom-1 links to cssom-2) to get the holistic document you'd like to work with. It's just more work for the editors to make sure any future edits to cssom-1 are correctly applied to cssom-2 as well.

@tabatkins

This comment has been minimized.

Copy link
Member

commented Jan 11, 2019

Since the W3C is exploring "living documents" (per last year's TPAC), can we prioritize putting CSSOM on that track? It, like Typed OM, is the sort of doc that regularly gets smaller edits, rather than large new features, and it's often very important for compat that said edits make it into the document promptly.

Then we dont' have to hem and haw over which level to put a feature in.

@astearns

This comment has been minimized.

Copy link
Member

commented Jan 11, 2019

I don't see hemming and hawing over spec levels as a bad thing - it's just one way of noting which parts of a spec are farther along than others. If we switch to a living document mode we'd have to do the same hemming and hawing over whether to mark a section stable.

I don't have a big preference on work mode for this spec - I'd prefer to leave it up to the editor or editors (are @rakina or @ericwilligers willing to edit CSSOM with this new feature added?). If there's concern that constructable stylesheets are going to need changes in current CSSOM level 1 text then it may make sense to change level 1 to a living document. But if the level 1 document could safely get to REC without the new feature, I think it would make sense to do that and create level 2 as a living document. But that's just me - I'd prefer to let @emilio and whoever else is actually doing the work choose what to do.

@emilio

This comment has been minimized.

Copy link
Collaborator

commented Jan 12, 2019

I'd prefer to have a single document to maintain if possible. Backporting fixes between two different documents is not really something I'd enjoy, and seems error-prone / prone to get out of sync quickly.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
6 participants
You can’t perform that action at this time.