Skip to content

Conversation

@jorydotcom
Copy link
Contributor

This is a draft charter template - a need per #207. Wasn't sure if this should go through the proposal process since it's a document we need to unblock other issues - if that's the case LMK and I will update the PR to put this is a proposal folder.

I used the Node TSC charter and the Kubernetes SIG Charter template as a basis. The trick is to make the charter document work for projects of different sizes, as there will be some information that will be applicable to large projects but not to the small ones. Hence, some of the sections I marked 'optional' but please do share your thoughts and comments on this!

## Section 2: Relationship with OpenJS Foundation CPC.

_directions: describe how the project intersects with the Cross Project_
_Council._
Copy link
Member

Choose a reason for hiding this comment

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

I’m not sure if it’s clear what to fill in this section.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

The Node TSC charter has these 2 paragraphs under its Section 2 about the relationship between the Node TSC and the CPC, I think they're good paragraphs & was imagining something like that would go here. I agree it's not super clear as written!

Copy link
Member

Choose a reason for hiding this comment

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

Perhaps the template would benefit from having links to good examples, such as this one that you mention from the Node.js TSC charter https://github.com/nodejs/TSC/blob/master/TSC-Charter.md#section-2-evolution-of-openjs-foundation-governance

_directions: describe the structure of the group responsible for managing_
_the project and its respective organization and repositories. If there are_
_specific rules for membership or participation in the group, list them here or_
_by reference to a governance.md document._
Copy link
Member

Choose a reason for hiding this comment

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

I’m not sure that the term “Establishment” can be widely understood. Maybe “Leadership” would be better?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

What about "Creation" - since this is more about the structure and arguably we'd want the projects to put "Leadership" pieces in their governance docs as much as possible to avoid the issue of them having to update their charter too frequently?

Copy link
Contributor

Choose a reason for hiding this comment

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

How about something more generic like "Project Structure"?

Copy link
Member

Choose a reason for hiding this comment

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

I think "Project Leadership" would be a good mix of what has been suggested and I think that is what is covered in the "Etablishment" section in the Node.js TSC charter.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

On the call yesterday, we discussed using 'Governing Body' which was well received because we already have a definition of that in our charter document. Updating PR with this language.

Copy link
Member

@joesepi joesepi left a comment

Choose a reason for hiding this comment

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

LGTM. I've made a few suggestions for adding examples. I find examples can give some clarity or spur thinking.

@joesepi
Copy link
Member

joesepi commented Aug 6, 2019

It was suggested in today's meeting that foundation legal review this as well. The thinking being that legal will need to approve any charters for existing or new projects.

Copy link
Member

@mcollina mcollina left a comment

Choose a reason for hiding this comment

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

LGTM

Jory Burson and others added 3 commits August 7, 2019 11:17
@jorydotcom
Copy link
Contributor Author

accepted @joesepi 's suggestions for example links. Another thing we could do is provide an example version of the Node Charter.

@jorydotcom
Copy link
Contributor Author

Pre-CPC meeting note: waiting on review from @kborchers & @mhdawson specifically as they are community board reps. If no other comments or edits are needed after that, Jory will send it off to @mkdolan & @aupdegrove per last week's discussion.

Copy link
Contributor

@kborchers kborchers left a comment

Choose a reason for hiding this comment

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

I left a question and a comment but otherwise this LGTM

_OpenJS Foundation's governance._


## Section 0: Guiding Principles (optional)
Copy link
Contributor

Choose a reason for hiding this comment

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

How do we want projects to handle these optional sections? IMO, the sections should still exist in every charter and if the project chooses not to complete it, they leave it blank or add N/A or something like that so that all charters have consistent numbering, sections, order, etc.

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've seen the phrase 'Intentionally Omitted' or 'Section Intentionally Left Blank' used for that purpose, if that works

Copy link
Contributor

Choose a reason for hiding this comment

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

👍 Works for me as long as the section heading remains to maintain consistency.

Copy link
Member

Choose a reason for hiding this comment

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

Of the 2 suggestions I prefer 'Section Intentionally Left Blank'

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 pushed a commit that adds the sentence: "If you are not using this section, please indicate your intent with the phrase, 'Section Intentionally Left Blank'." to the optional sections

_directions: describe the structure of the group responsible for managing_
_the project and its respective organization and repositories. If there are_
_specific rules for membership or participation in the group, list them here or_
_by reference to a governance.md document._
Copy link
Contributor

Choose a reason for hiding this comment

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

How about something more generic like "Project Structure"?

Copy link
Member

@mhdawson mhdawson left a comment

Choose a reason for hiding this comment

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

LGTM with a few suggestions

@mhdawson
Copy link
Member

@jorydotcom thanks for putting this together. Looks great :)

Copy link
Contributor

@MylesBorins MylesBorins left a comment

Choose a reason for hiding this comment

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

LGTM

@MylesBorins
Copy link
Contributor

Would be good to have a review from @aupdegrove before a project uses this.

@jorydotcom
Copy link
Contributor Author

Just to update: this has been sent off to @mkdolan & @brianwarner to get @aupdegrove legal review.

@jorydotcom
Copy link
Contributor Author

removed the agenda label for now since this is at legal for review, and is tracked on our onboarding project.

@brianwarner
Copy link
Contributor

This draft is good to go.

@joesepi joesepi merged commit 83a812b into openjs-foundation:master Oct 15, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.