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

Add Community Committee to the About section #1465

Merged
2 commits merged into from
Nov 29, 2017
Merged

Conversation

amiller-gh
Copy link
Member

Addresses nodejs/community-committee#134

Took a first pass at content, but would love for the CommComm group to help wordsmith it! Have at it.


# Community Committee

The Community Committee (CommComm) is a top-level committee in the Node.js Foundation focused on community-facing efforts. Code commits !== the only way to contribute!
Copy link
Member Author

Choose a reason for hiding this comment

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

Do we want to abbreviate to CommComm or CC?

Copy link
Contributor

Choose a reason for hiding this comment

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

I'd stick with CommComm, that's what it's called most of the time, from what I've seen

Choose a reason for hiding this comment

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

I agree with sticking to CommComm.

Copy link
Contributor

Choose a reason for hiding this comment

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

+1 to CommComm - I believe CC was confusing with the former CTC, but since that was absorbed into the TSC we've stuck with CommComm 😄


The Community Committee (CommComm) is a top-level committee in the Node.js Foundation focused on community-facing efforts. Code commits !== the only way to contribute!

The CommComm has authority over community outreach including:
Copy link
Member Author

Choose a reason for hiding this comment

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

Please correct me if anything is wrong or missing!

Copy link
Contributor

Choose a reason for hiding this comment

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

The CommComm has authority over outward-facing community outreach efforts, including:

I think this may be a bit more concise 😄

- Project Moderation/Mediation
- Public Outreach and [Publications](https://medium.com/the-node-js-collection)

There are four levels of engagement with the Community Committee:
Copy link
Member Author

Choose a reason for hiding this comment

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

Don't know if this is the right verbiage. Engagement? Commitment? Involvement?

Copy link
Contributor

Choose a reason for hiding this comment

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

I'd go with involvment, engagement seems too definitive for me

Choose a reason for hiding this comment

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

I'd add in Internationalization Working Group info

Copy link
Contributor

Choose a reason for hiding this comment

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

+1 to involvement over engagement 👍


## Membership

To become a member of the Community Committee, start participating! You must:
Copy link
Member Author

Choose a reason for hiding this comment

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

Probably a better section intro to be had here.

Copy link
Contributor

@bnb bnb Nov 13, 2017

Choose a reason for hiding this comment

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

If you're interested in participating in the Community Committee or the projects it works on, there are a few ways you can get involved:

Suggested change - totally open to feedback/iterations.


Membership is for 6 months. The group will ask on a regular basis if the expiring members would like to stay on. A member just needs to reply to renew. There is no fixed size of the CommComm. However, the expected target is between 9 and 12. You can read more about membership, and other administrative details, in our [Governance Guide](https://github.com/nodejs/community-committee/blob/master/GOVERNANCE.md).

Regular CommComm meetings are held bi-monthly in a Zoom video conference, and broadcast live to the public on YouTube. Meeting announcements and agendas are posted before the meeting begins in the organization's [GitHub issues](https://github.com/nodejs/community-committee/issues). Any community member or contributor can ask that something be added to the next meeting's agenda by logging a GitHub Issue.
Copy link
Member Author

Choose a reason for hiding this comment

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

Is there a better way for newbies to discover when/how meetings are held? Right now its "keep an eye out on the issues list for the announcement". Not the easiest way for those not plugged in yet to engage.

Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe advertise the timing of the meetings? Although I realize it's subject to change. But we know it's definitely on thursday at a precise UTC hour?

Copy link
Contributor

Choose a reason for hiding this comment

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

One way to keep on top of meetings (not just CommComm, but all Node.js meetings):

That will alert anyone interested in when a livestream is going online, and (if the stream is scheduled beforehand, something @rachelnicole and I need to work on doing) get notice well before the stream is actually live 👍

Copy link
Member

Choose a reason for hiding this comment

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

It should also be on the standard calendar, and its at a regular time so unless it changes it should be easy to know when the next one is: https://nodejs.org/calendar

@@ -39,6 +39,10 @@
"link": "about/governance",
"text": "Governance"
Copy link
Member Author

Choose a reason for hiding this comment

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

Note: The TSC is still under a tab called "Governance". We are under a new side bar called "Community". There is definitely a better IA for the site. Figured we'd save that for a larger re-design though. Can anyone think of a better stop-gap solution?

Copy link
Contributor

Choose a reason for hiding this comment

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

I really can't, but totally open to suggestions 😬

1. A **Contributor** is any individual creating or commenting on an issue or pull request.
2. A **Collaborator** is a contributor who has been given write access to the repository
3. An **Observer** is any individual who has requested or been requested to attend a CommComm meeting. It is also the first step to becoming a Member.
4. A **Member** is a collaborator with voting rights who has met the requirements of participation and voted in by the CommComm voting process.
Copy link
Contributor

Choose a reason for hiding this comment

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

This seems a bit misleading to me, but maybe I've got some misconception.
This seems to say that there's some sort of hierarchy between those levels. But, unless I'm wrong, I see two different kind of involvments. Contributor/Collaborator on one side, and Observer/Member on the other side. For instance, you don't have to be Collaborator to become an Observer AFAIK, but this seems to say so.

Maybe at least turn this into a bullet list?

Choose a reason for hiding this comment

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

I agree. Lets switch to a bullet list.

Copy link
Contributor

Choose a reason for hiding this comment

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

TIL that "Collaborator" is an official class of participation in the CommComm, as defined in our Charter. We've strayed from that, mostly using Contributor, Observer, and Member - so we may need to go update the Charter in a bit here 😅

I do think the structure here is good, since it is the typical flow of how you'd go from being a contributor to a member, but definitely +1 to changing this to a bullet list.

Copy link
Contributor

Choose a reason for hiding this comment

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

TIL that "Collaborator" is an official class of participation in the CommComm, as defined in our Charter. We've strayed from that, mostly using Contributor, Observer, and Member - so we may need to go update the Charter in a bit here 😅

I do think the organization right now is good, since it's the general flow of how you'd go from being a collaborator to a member, but definitely +1 to making it bullets instead of a list.


Membership is for 6 months. The group will ask on a regular basis if the expiring members would like to stay on. A member just needs to reply to renew. There is no fixed size of the CommComm. However, the expected target is between 9 and 12. You can read more about membership, and other administrative details, in our [Governance Guide](https://github.com/nodejs/community-committee/blob/master/GOVERNANCE.md).

Regular CommComm meetings are held bi-monthly in a Zoom video conference, and broadcast live to the public on YouTube. Meeting announcements and agendas are posted before the meeting begins in the organization's [GitHub issues](https://github.com/nodejs/community-committee/issues). Any community member or contributor can ask that something be added to the next meeting's agenda by logging a GitHub Issue.
Copy link
Contributor

Choose a reason for hiding this comment

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

Maybe advertise the timing of the meetings? Although I realize it's subject to change. But we know it's definitely on thursday at a precise UTC hour?


The CommComm follows a [Consensus Seeking](https://en.wikipedia.org/wiki/Consensus-seeking_decision-making) decision making model.

When an agenda item has appeared to reach a consensus, the moderator will ask "Does anyone object?" as a final call for dissent from the consensus. If a consensus cannot be reached that has no objections then a majority wins vote is called. It is expected that the majority of decisions made by the CommComm are via a consensus seeking process and that voting is only used as a last-resort.
Copy link
Contributor

Choose a reason for hiding this comment

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

It may be a bit too early, but #169 of CommCoom seems to indicate we all agree on the principle. So maybe we can add a bit on the Condorcet voting?

Copy link
Contributor

Choose a reason for hiding this comment

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

I'd err on the side of landing this PR and then updating once nodejs/community-committee#169 is resolved 👍

Copy link
Contributor

@bnb bnb left a comment

Choose a reason for hiding this comment

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

Generally LGTM - this could be shipped as-is if needed, but I've included some change requests to optimize it a bit ❤️

1. A **Contributor** is any individual creating or commenting on an issue or pull request.
2. A **Collaborator** is a contributor who has been given write access to the repository
3. An **Observer** is any individual who has requested or been requested to attend a CommComm meeting. It is also the first step to becoming a Member.
4. A **Member** is a collaborator with voting rights who has met the requirements of participation and voted in by the CommComm voting process.
Copy link
Contributor

Choose a reason for hiding this comment

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

TIL that "Collaborator" is an official class of participation in the CommComm, as defined in our Charter. We've strayed from that, mostly using Contributor, Observer, and Member - so we may need to go update the Charter in a bit here 😅

I do think the structure here is good, since it is the typical flow of how you'd go from being a contributor to a member, but definitely +1 to changing this to a bullet list.

To become a member of the Community Committee, start participating! You must:

1. Attend the bi-weekly meetings, investigate issues tagged as good first issue, file issues and pull requests, and provide insight via GitHub.
2. Request to become an Observer by filing an issue. Once added as an Observer to meetings, we will track attendance and participation for 3 months, as according to our governance guidelines.
Copy link
Contributor

Choose a reason for hiding this comment

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

Request to become an Observer by filing an issue (here's an example of a request).

Minor change, adding in an example 😊


# Community Committee

The Community Committee (CommComm) is a top-level committee in the Node.js Foundation focused on community-facing efforts. Code commits !== the only way to contribute!
Copy link
Contributor

Choose a reason for hiding this comment

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

+1 to CommComm - I believe CC was confusing with the former CTC, but since that was absorbed into the TSC we've stuck with CommComm 😄


The Community Committee (CommComm) is a top-level committee in the Node.js Foundation focused on community-facing efforts. Code commits !== the only way to contribute!

The CommComm has authority over community outreach including:
Copy link
Contributor

Choose a reason for hiding this comment

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

The CommComm has authority over outward-facing community outreach efforts, including:

I think this may be a bit more concise 😄

- Project Moderation/Mediation
- Public Outreach and [Publications](https://medium.com/the-node-js-collection)

There are four levels of engagement with the Community Committee:
Copy link
Contributor

Choose a reason for hiding this comment

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

+1 to involvement over engagement 👍


## Membership

To become a member of the Community Committee, start participating! You must:
Copy link
Contributor

@bnb bnb Nov 13, 2017

Choose a reason for hiding this comment

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

If you're interested in participating in the Community Committee or the projects it works on, there are a few ways you can get involved:

Suggested change - totally open to feedback/iterations.


To become a member of the Community Committee, start participating! You must:

1. Attend the bi-weekly meetings, investigate issues tagged as good first issue, file issues and pull requests, and provide insight via GitHub.
Copy link
Contributor

Choose a reason for hiding this comment

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

I started rewriting this one bullet, but it quickly grew beyond what a single bullet should be 😬

I'd like to suggest a full rework of this section - feel free to modify or suggest any changes.

- Attend the bi-weekly CommComm meetings - you can request the bi-weekly meetings by requesting to become an observer (see an example of such a request [here](https://github.com/nodejs/community-committee/issues/142)). Once added as an Observer to meetings, we will track attendance and participation for 3 months as a part of becoming a membership, as defined by the CommComm Governance.
- Take on introductory issues labeled as "Good First Issue", file issues with your ideas for what the CommComm can work on, create  pull requests with improvements to our existing work, and help us by sharing your thoughts and ideas in the ongoing discussions we're having in GitHub.
- Participate in our ongoing efforts around community building - like localization, evangelism, the Node.js Collection, and others - by digging into their respective repositories and getting involved!


Membership is for 6 months. The group will ask on a regular basis if the expiring members would like to stay on. A member just needs to reply to renew. There is no fixed size of the CommComm. However, the expected target is between 9 and 12. You can read more about membership, and other administrative details, in our [Governance Guide](https://github.com/nodejs/community-committee/blob/master/GOVERNANCE.md).

Regular CommComm meetings are held bi-monthly in a Zoom video conference, and broadcast live to the public on YouTube. Meeting announcements and agendas are posted before the meeting begins in the organization's [GitHub issues](https://github.com/nodejs/community-committee/issues). Any community member or contributor can ask that something be added to the next meeting's agenda by logging a GitHub Issue.
Copy link
Contributor

Choose a reason for hiding this comment

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

One way to keep on top of meetings (not just CommComm, but all Node.js meetings):

That will alert anyone interested in when a livestream is going online, and (if the stream is scheduled beforehand, something @rachelnicole and I need to work on doing) get notice well before the stream is actually live 👍


The CommComm follows a [Consensus Seeking](https://en.wikipedia.org/wiki/Consensus-seeking_decision-making) decision making model.

When an agenda item has appeared to reach a consensus, the moderator will ask "Does anyone object?" as a final call for dissent from the consensus. If a consensus cannot be reached that has no objections then a majority wins vote is called. It is expected that the majority of decisions made by the CommComm are via a consensus seeking process and that voting is only used as a last-resort.
Copy link
Contributor

Choose a reason for hiding this comment

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

I'd err on the side of landing this PR and then updating once nodejs/community-committee#169 is resolved 👍

@@ -39,6 +39,10 @@
"link": "about/governance",
"text": "Governance"
Copy link
Contributor

Choose a reason for hiding this comment

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

I really can't, but totally open to suggestions 😬

@amiller-gh
Copy link
Member Author

Updated with feedback 😁

@bnb, regarding your "one bullet rewrite" 😉 I've re-worked the section headers to improve the document flow a bit and I believe it should cover all the bases you mentioned.

The intro section lays out the four types of involvement Contributor, Collaborator, Observer and Member. The following two sections then deep-dive into Contributors and Collaborators and Observers and Membership. Your rewritten bullets have been integrated into both sections where they seemed to belong, and the Observers and Membership section emphasizes that your work as a Contributor/Collaborator is a factor in becoming a member (Section 3, Item 1).

  • Attend the bi-weekly CommComm meetings - you can request the bi-weekly meetings by requesting to become an observer (see an example of such a request here). Once added as an Observer to meetings, we will track attendance and participation for 3 months as a part of becoming a membership, as defined by the CommComm Governance.

☝️ This language is items 1, 2 and 3 in Observers and Membership

  • Take on introductory issues labeled as "Good First Issue", file issues with your ideas for what the CommComm can work on, create pull requests with improvements to our existing work, and help us by sharing your thoughts and ideas in the ongoing discussions we're having in GitHub.
  • Participate in our ongoing efforts around community building - like localization, evangelism, the Node.js Collection, and others - by digging into their respective repositories and getting involved!

☝️ This language is featured prominently in the Contributors and Collaborators section

Give it a read through and see if it works for you – if you have a more preferred way to structure it, let me know! Happy to keep tweaking.

@bnb
Copy link
Contributor

bnb commented Nov 28, 2017

@amiller-gh just went through the changes, and they LGTM! If we need to update later, we can. Thank you VERY much for this contribution! 🙏

Copy link

@ghost ghost left a comment

Choose a reason for hiding this comment

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

LGTM, let's land this.

This pull request was closed.
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.

5 participants