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

Initial draft of a CG/WG Staging process doc #4

Merged
merged 18 commits into from
Oct 8, 2024

Conversation

bumblefudge
Copy link
Contributor

@bumblefudge bumblefudge commented Sep 27, 2024

At W3C TPAC 2024, I witnessed @hlflanagan and @wseltzer leading joint CG/WG sessions masterfully implementing sam goto's process doc to direct traffic and provide guidelines for discussion. Serendipitously, @plehegar suggested our CG consider a similar process for how to promote some CG work to normative work in future WGs and/or existing WGs in W3C.

As a potential process addendum, I "forked" @samuelgoto 's doc and adapted it a bit to work we do here. I would suggest we discuss this before making any decisions about chartering normative groups but after establishing some more formal CG charter docs.

EDIT: tantek asked me for a diff to compare my opinionated initial draft to samgoto's inspiration doc, which I used a github gist to produce here. (See tutorial here if you'd like to use this trick in the future to compare any two versions of a file and create a GH permalink for the diff!)

@dmitrizagidulin
Copy link
Member

Historical side-note -- the process doc itself has roots in WHATWG's process, which itself was inspired by ECMA's https://tc39.es/ process docs.

@samuelgoto
Copy link
Contributor

Historical side-note -- the process doc itself has roots in WHATWG's process, which itself was inspired by ECMA's https://tc39.es/ process docs.

Yeah, +1. I think I capture that in this section here [1]?

[1]
https://github.com/w3c-fedid/Administration/blob/main/proposals-CG-WG.md#prior-art

@dmitrizagidulin
Copy link
Member

Yeah, +1. I think I capture that in this section here [1]?

Oh, whoops, thanks :) (I'll leave the comment for lazy ppl like me :) )

Copy link
Contributor

@samuelgoto samuelgoto left a comment

Choose a reason for hiding this comment

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

LGTM

Thanks for putting this together! I love the deltas and may borrow some of them for us too at the FedID CG/WG!!

stage-process.md Show resolved Hide resolved
stage-process.md Outdated Show resolved Hide resolved
stage-process.md Outdated Show resolved Hide resolved
@bumblefudge
Copy link
Contributor Author

bumblefudge commented Oct 4, 2024

@cwilso I never thanked you on list for your helpful email to the list about CG<-->WG relations. I figured I should ping you here for visibility. if you or any interested parties on the AB and/or AC have the bandwidth, feel free to watch this repo, comment on its PRs, etc etc. We are discussing a CG charter today, and hopefully the CG<>WG workflow document and one or more WG charters will be discussed as well in the coming weeks.

Copy link
Contributor

@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.

I think overall this is looking really good, with well-considered improvements from the Fed ID CG/WG stages doc, which I hope can go both ways (towards a goal of making these as much the same as possible, especially for two efforts in such closely adjacent/aligned spaces — FedID and Social Web).
I added one IMO critical fix here that's mostly about reverting to the text in the Fed ID CG/WG Stages proposal, because the intent of Stages is to incubate new things, not to review every small decision. I believe this Suggested edit captures that while retaining the intent we want of incubating both new features in existing specs and potentially proposed new specs.

stage-process.md Outdated Show resolved Hide resolved
dmitrizagidulin and others added 13 commits October 4, 2024 15:45
@ianbjacobs
Removed the paragraph on not sing the cg contrib list and not doing contributions on mail list (when using GitHub).  that latter sentence was being dropped by users of the template.  it's not necessary so making the template consistent with use.
@ianbjacobs @wseltzer
The test suite section for the CG Charter template points to a page that is only about WGs.  It includes the 2 ways to include test suites in a WG (either as part of the spec or not) and also directly refers to the W3C patent policy.  It's not at all relevant to CGs. 

It would be better just to point to the GitHub LICENSE.md file if in GitHub.

 I followed links in that material until I found the W3C license used and proposed putting that in the LICENSE.md file for the WebVR CG.   That's a separate change I'll suggest in the W3C LICENSE.md file for CGs.
changed it to link to the license section of the charter (since we don't know where they will put their charter in their GitHub repo)
@ianbjacobs
Got this from Google in second screen CG.
Install tidy from http://binaries.html-tidy.org
Download tidyconfig.txt:
https://raw.githubusercontent.com/w3c/presentation-api/gh-pages/build/tidyconfig.txt
Run tidy on command line:
tidy -config tidyconfig.txt -o output.html input.html
Copy link
Contributor

@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.

Thank you for the quick merge of retaining "features" wording. This looks good enough to land and keep iterating, with @samuelgoto's approval. Would also like @cwilso to take a look at this.

@samuelgoto
Copy link
Contributor

This looks good enough to land and keep iterating, with @samuelgoto's approval.

LGTM++

I'm excited to bring these diffs to the base and see others use this too! Good stuff @bumblefudge !!

@dmitrizagidulin
Copy link
Member

Remaining steps for this PR to be merged: adding the changes requested by Emelia on the call. (add more references to existing FEP process etc)

@dmitrizagidulin
Copy link
Member

@bumblefudge Nicely done! That addresses the remaining change requests from @ThisIsMissEm on the call.
Should be ready to merge (for further discussion by the group).

@dmitrizagidulin dmitrizagidulin merged commit 185a00f into swicg:main Oct 8, 2024
@ThisIsMissEm
Copy link
Contributor

Yeah, I think that works (granted I'm reviewing on mobile so hopefully I didn't miss anything)

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.