Skip to content
This repository has been archived by the owner on Mar 25, 2018. It is now read-only.

Update membership section of GOVERNANCE #54

Merged
merged 3 commits into from
Jan 22, 2016

Conversation

chrisdickinson
Copy link
Contributor

While running through the responses to the call for membership, I realized that the existing GOVERNANCE document was a bit lax on details for membership. Specifically, it did not answer:

  • Who should be members?
  • What are members expected to do?
  • How should individuals go about becoming a member?
  • Under what circumstances does a member leave the WG?

In addition, the CONTRIBUTING doc was a bit off from where we're at right now: it's expected, at least in the near term future, that we'll be operating primarily in the nodejs/node repo.

This PR attempts to address the questions above and is meant as jumping off point for discussion! I'm going to cc the folks who have publicly raised their hand to help out on this issue too, to make sure they're OK with all of this. In addition, I will reach out privately to all Node collaborators who have touched the docs in the last 6 months who are not part of the Docs WG.

This does not address process, goal-setting, or tooling, but that should follow in subsequent PRs to be discussed by the WG and CTC.

/cc @nodejs/documentation
/cc @mikeal — could you make sure this looks okay w/r/t WG setup?
/cc @rvagg — You've expressed interest in the operation of the Docs WG in other issues, and I'd love your thoughts on this.
/cc @kosamari, @a0viedo — you've both raised your hands to help out (thank you!), are there any questions you have that the membership section doesn't answer? Are the responsibilities and access outlined here in line with what you'd expect, or is it too much?


Membership in the Node.js Documentation WG entails the following access:

* Membership in the [Node.js Documentation Slack][nodejs-doc-slack].
Copy link
Contributor Author

Choose a reason for hiding this comment

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

I started a Slack team because:

  • A real-time channel of communications has proven useful to other WGs,
  • The existing Gitter channel was a bit of a ghost town,
  • Slack is a bit more user-friendly for non-technical folks than IRC or Gitter,
  • The integrations for Slack making keeping track of changes to the docs easier.

@distracteddev
Copy link

If we've moved to Slack, which I definitely think we should, then can we remove the gitter badge from the readme and officially close down the gitter channel if there's anyone left in it?

@bengl
Copy link
Member

bengl commented Jan 19, 2016

Everything looks like it was addressed to LGTM.

@chrisdickinson
Copy link
Contributor Author

Merging this now. Thanks all!

chrisdickinson added a commit that referenced this pull request Jan 22, 2016
Update membership section of GOVERNANCE
@chrisdickinson chrisdickinson merged commit ae07806 into master Jan 22, 2016
@chrisdickinson chrisdickinson deleted the update-governance-membership branch January 22, 2016 04:33
@rvagg
Copy link
Member

rvagg commented Jan 27, 2016

apologies for not finding the time to review this after being pulled in, it sounds like it's going well though so +1!

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants