w3c / WebID

https://www.w3.org/groups/cg/webid
MIT License
14 stars 7 forks source link

Init README #30

Closed csarven closed 7 months ago

csarven commented 8 months ago

Closes https://github.com/w3c/WebID/issues/18 https://github.com/w3c/WebID/issues/26

melvincarvalho commented 8 months ago

-1 too many bureaucratic dependencies, puts work at risk

This would require many months of debate and discussion to agree on all items.

A good README is a plus though

jacoscaz commented 8 months ago

Insofar as I can see, and please correct me if I am wrong, this PR only introduces one additional dependency (https://www.w3.org/Consortium/cepc/) on top of the ones that would be introduced by https://github.com/w3c/WebID/pull/31 .

However, https://github.com/w3c/WebID/pull/31 does introduce a significant number of dependencies and constraints which makes discussing the changes brought by these two PR separately a bit awkward as one cannot be merged without the other.

As chair, I would suggest closing these two PRs and opening a new one that includes the changes brought by both of them.

csarven commented 8 months ago

How about processing PR 31, and then this PR (30) ?

It is also possible to process both at the same time. This PR (30) merely references a CONTRIBUTING document. If the contents of CONTRIBUTING changes, it makes no difference to the README because we'd still want people to discover CONTRIBUTING.

csarven commented 8 months ago

And, I would add that, neither this PR (30) or PR 31 "introduces" an additional dependency with W3C Code of Ethics and Professional Conduct.

https://www.w3.org/community/about/faq/#code-of-conduct :

Is there a code of conduct for CG/BG participants? Yes. See the participation policies of the CG Process and the W3C Code of Ethics and Professional Conduct.

Joining a CG requires the participant to agree with the following when they sign the contributor agreement:

I agree to participate in the WebID Community Group under the terms of the Community and Business Group Process. I agree to abide by the terms and spirit of the Code of Ethics and Professional Conduct. I agree to participate as an individual under the W3C Community Contributor License Agreement (summary). (Required)

Reference to the W3C CEPC is merely a reminder and maintaining expectations when communicating and working in the W3C environment. It is not an "additional dependency".

jacoscaz commented 8 months ago

/chair hat on

As also discussed in https://github.com/w3c/WebID/pull/31, I was wrong in considering the CEPC an additional dependency. As for treating these as separate PRs or not... Perhaps consider adding an empty-ish CONTRIBUTING.md to this PR so that merging this doesn't result in a broken link?

/chair hat off

I agree with this PR as-is. +1 from me.

melvincarvalho commented 8 months ago

I suggest we hold off on finalizing CONTRIBUTING.md until we've had a chance to thoroughly review each section and reach a consensus within the group. Should a particular issue arise that requires immediate attention, we can certainly focus on that specific section as needed.

In keeping with WebID's tradition of streamlined processes, we should be mindful of avoiding overly complex procedures that can lead to unnecessary debates and hinder our progress. It's important to remember that even a single contentious point can jeopardize our collective efforts, especially given our limited resources.

For now, let's continue as we have for the past six months, focusing on the one new work item, which has gained rough consensus, based on the guidance of our chair. Recent influxes of revisions to historical documents have been distracting from our primary objectives. These historical initiatives have been simmering for many years and can wait a little longer. By prioritizing our current tasks, we aim to successfully complete our most pressing work.

melvincarvalho commented 8 months ago

Perhaps consider adding an empty-ish CONTRIBUTING.md

I'm -0 on this. But it could be done, if it is really is emtpy-ish ie lightweight and contains no possible gotchas. Make it clear it's informative and has not had full group ratification or endorsement.

melvincarvalho commented 8 months ago

I agree to participate in the WebID Community Group under the terms of the Community and Business Group Process. I agree to abide by the terms and spirit of the Code of Ethics and Professional Conduct. I agree to participate as an individual under the W3C Community Contributor License Agreement (summary). (Required)

If it's implicit, then we're already good. That takes away any urgency.

jacoscaz commented 7 months ago

/chair hat on

Closing as superseded by #47 .