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

Suggested charter edits and additions #255

Merged
merged 14 commits into from
Aug 2, 2023
Merged

Suggested charter edits and additions #255

merged 14 commits into from
Aug 2, 2023

Conversation

vmbrasseur
Copy link
Contributor

  • Add title and table of contents
  • Add a section about removal of steering committee members
  • Change §2 from company to organization to better include non-corporate members
  • Explicitly say the organization must be a member of LF to qualify for membership
  • Include real-time chat and GitHub as communication methods
  • "All members shall encourage…" to "All members may encourage…" to remove implied recruiting requirement
  • Fix a typo that was preventing hyperlinking of CC-BY

* Add title and table of contents
* Add a section about removal of steering committee members
* Change §2 from company to organization to better include non-corporate members
* Explicitly say the organization must be a member of LF to qualify for membership
* Include real-time chat and GitHub as communication methods
* "All members shall encourage…" to "All members may encourage…" to remove implied recruiting requirement
* Fix a typo that was preventing hyperlinking of CC-BY
@vmbrasseur vmbrasseur requested a review from a team as a code owner January 2, 2023 23:34
@vmbrasseur vmbrasseur requested review from ashleywolf, gkunz and anajsana and removed request for a team January 2, 2023 23:34
@vmbrasseur vmbrasseur changed the title Suggested edits and additions Suggested charter edits and additions Jan 2, 2023
@vmbrasseur
Copy link
Contributor Author

The TOC isn't working but I'm not fussed about that.

Copy link
Member

@anajsana anajsana left a comment

Choose a reason for hiding this comment

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

Thanks a lot for the PR @vmbrasseur!! overall, the changes LGTM. I just made a small comment on line 43 to see if it makes sense to specify what we consider "regular non-participation" in this context

CHARTER.adoc Outdated Show resolved Hide resolved
CHARTER.adoc Outdated Show resolved Hide resolved
CHARTER.adoc Show resolved Hide resolved
CHARTER.adoc Outdated Show resolved Hide resolved
CHARTER.adoc Show resolved Hide resolved
CHARTER.adoc Outdated Show resolved Hide resolved
CHARTER.adoc Outdated Show resolved Hide resolved
CHARTER.adoc Outdated Show resolved Hide resolved
CHARTER.adoc Show resolved Hide resolved
CHARTER.adoc Outdated Show resolved Hide resolved
CHARTER.adoc Show resolved Hide resolved
@anajsana
Copy link
Member

I've requested some extra changes to the doc. I'd also like to suggest changing the title "charter" to "general-member-charter". The document only talks about the responsibilities, way of work and rights for TODO General Members, and not the TODO Group as a whole (that currently, also includes the people behind the OSPOlogy community, OSPO Associates, etc). If we don't specify, maybe people that are active contributors in the community, or OSPO associates representatives can feel excluded because the document does not mention them. What do you think? (cc @vmbrasseur )

CHARTER.adoc Outdated Show resolved Hide resolved
@lhawthorn
Copy link

Feel free to add me as a reviewer for these changes. I will take a look at the latest first thing tomorrow morning.

@lhawthorn
Copy link

I am not sure if this is the correct place to leave feedback, but I will drop here anyway so it does not get lost.

The text at https://github.com/todogroup/governance/blob/main/CHARTER.adoc does not match the text at https://github.com/todogroup/governance/blob/main/TODO%20Charter%20and%20Agreement%20v2.0.pdf.

As the PDF is the official agreement members sign, we need to ensure that the document and the charter match. I do not know how we go about getting proposed changes approved by LF and the membership agreement (which includes the charter) updated, but it needs to be done. The charter at https://github.com/todogroup/governance/blob/main/CHARTER.adoc includes substantial revision to Section 3, Article A, clause II, inserting this language "including approving new programs and initiatives that make use of the TODO Group name, logo, or branding, and approving use of the TODO Group name, logo, or branding for sponsorship or endorsement purposes;" at the conclusion of the clause "overseeing all business and marketing matters, "

If we're going to revise the charter, we MUST ensure consistency between these documents, or people are signing a legal agreement that differs from what we are currently presenting as the charter of the TODO Group in the ASCII doc file.

@lhawthorn
Copy link

lhawthorn commented Feb 1, 2023

Referring to document text as it appears here:
https://github.com/todogroup/governance/blob/main/CHARTER.adoc

Section 11, Article A, Clause III
If I am reading this correctly, TODO SC members are elected for a two year term. If that's correct, let's just make it explicit. If I am not reading it correctly, I will not be the only one to do so and we should spell out 1 year term (or 6 day term, etc., whatever is accurate. :) )

Section 11, Article A, Clause VIII
This clause refers to appointing a member only, but mentions "elections or appointment purposes" in the last sentence of the clause. This is confusing. We should drop the word elections here.

Section 11, Article C
To whom are the issues that the SC are unable to resolve referred? It just says LF. We should be explicit what position/role is responsible for adjudicating upon the issue and, if possible, our responsibilities as the SC to present information to the LF person to be best prepared to adjudicate.

@lhawthorn
Copy link

General ideas:
Replace use of IRC with real-time chat. A tool should not be specified in the charter, but the means of communication.

Definition of initial work of working groups could be expanded and we should consider doing this intentionally to incentive contribution in particular areas. It could be as simple as saying "we will solicit for working group ideas in $REPO etc where detailed information is contained in that repo with revision history.

CHARTER.adoc Outdated Show resolved Hide resolved
CHARTER.adoc Outdated Show resolved Hide resolved
CHARTER.adoc Show resolved Hide resolved
CHARTER.adoc Outdated Show resolved Hide resolved
anajsana and others added 2 commits February 28, 2023 10:11
Co-authored-by: Annania Melaku <[email protected]>
Signed-off-by: Ana Jimenez Santamaria <[email protected]>
Co-authored-by: Georg Kunz <[email protected]>
Signed-off-by: Ana Jimenez Santamaria <[email protected]>
@caniszczyk
Copy link
Member

caniszczyk commented Mar 1, 2023 via email

anajsana and others added 2 commits March 28, 2023 11:48
Co-authored-by: Georg Kunz <[email protected]>
Signed-off-by: Ana Jimenez Santamaria <[email protected]>
Signed-off-by: Ana Jimenez Santamaria <[email protected]>
anajsana and others added 5 commits March 28, 2023 11:50
Signed-off-by: Ana Jimenez Santamaria <[email protected]>
Co-authored-by: Georg Kunz <[email protected]>
Signed-off-by: Ana Jimenez Santamaria <[email protected]>
Signed-off-by: Ana Jimenez Santamaria <[email protected]>
Co-authored-by: Georg Kunz <[email protected]>
Signed-off-by: Ana Jimenez Santamaria <[email protected]>
@@ -46,15 +57,15 @@ The TODO Group will host Working Groups for members to contribute to that are in
... Meetings will occur at least once per quarter.
... Details of meeting mechanisms and instructions for attendance will be published reasonably in advance to all members in good standing.
.. Communication mechanisms
... All public communication not during meetings will take place over the public group mailing list(s) accessible to members and non-members alike.
... All private communication not during meetings will take place over the private group mailing list for members only.
... All public communication not during meetings will take place over the public group mailing list(s), real-time chats, issue trackers, or source code management systems and will be accessible to members and non-members alike.
Copy link
Member

@anajsana anajsana Mar 28, 2023

Choose a reason for hiding this comment

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

Suggested change
... All public communication not during meetings will take place over the public group mailing list(s), real-time chats, issue trackers, or source code management systems and will be accessible to members and non-members alike.
... Communication is divided between community (public) and general members (private). The general members at times share sensitive information and use a private channel for that type of discussion. Some of the information shared in those channels is later anonymized and shared with the wider OSPO community via [OSPO Discussions](https://github.com/todogroup/ospology/discussions).
... All public communication not during meetings will take place over the public group mailing list(s), real-time chats, issue trackers, or source code management systems and will be accessible to members and non-members alike.

Copy link
Contributor

Choose a reason for hiding this comment

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

This is fine for me to include in the charter.

Copy link
Member

Choose a reason for hiding this comment

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

LGTM. Somewhat nit picky... Are all discussions from the private channel anonymized and shared in OSPO Discussions? If not, can say "Some of the information shared in those channels are later anonymized..."

Choose a reason for hiding this comment

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

LGTM with @annania's recommendation to say "some of the information" as it is an accurate synopsis of our operating processes. Please merge after that change has been made.

Copy link
Member

Choose a reason for hiding this comment

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

In practice, any information shared on Slack that is meaningful (e.g conversations that get lots of attraction and a long discussion around) and will help the overall community is always shared anonymously. The topics that are not shared are those who are informal conversations that do not provide "value" or topics that are duplicated and also discussed in the public channels

GM-SC-CHARTER.adoc Outdated Show resolved Hide resolved
GM-SC-CHARTER.adoc Show resolved Hide resolved
@anajsana
Copy link
Member

I am not sure if this is the correct place to leave feedback, but I will drop here anyway so it does not get lost.

The text at https://github.com/todogroup/governance/blob/main/CHARTER.adoc does not match the text at https://github.com/todogroup/governance/blob/main/TODO%20Charter%20and%20Agreement%20v2.0.pdf.

As the PDF is the official agreement members sign, we need to ensure that the document and the charter match. I do not know how we go about getting proposed changes approved by LF and the membership agreement (which includes the charter) updated, but it needs to be done. The charter at https://github.com/todogroup/governance/blob/main/CHARTER.adoc includes substantial revision to Section 3, Article A, clause II, inserting this language "including approving new programs and initiatives that make use of the TODO Group name, logo, or branding, and approving use of the TODO Group name, logo, or branding for sponsorship or endorsement purposes;" at the conclusion of the clause "overseeing all business and marketing matters, "

If we're going to revise the charter, we MUST ensure consistency between these documents, or people are signing a legal agreement that differs from what we are currently presenting as the charter of the TODO Group in the ASCII doc file.

@lhawthorn Once the Steering Committee agrees on the final version of the charter contained in this PR. I will open a ticket to LF legal team for review. If approved, the PR will be merged and changes will be mirrored to the .adoc document. 👍

anajsana added 2 commits April 5, 2023 17:52
Signed-off-by: Ana Jimenez Santamaria <[email protected]>
Copy link
Member

@anajsana anajsana left a comment

Choose a reason for hiding this comment

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

Restore shall encourage to the charter

GM-SC-CHARTER.adoc Outdated Show resolved Hide resolved
@anajsana anajsana dismissed tsteenbe’s stale review June 9, 2023 14:07

those changes were already made

Signed-off-by: Ana Jimenez Santamaria <[email protected]>
Copy link
Member

@anajsana anajsana left a comment

Choose a reason for hiding this comment

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

Define technical communications and explain that all technical communications and decisions must be public

.. Communication mechanisms
... All public communication not during meetings will take place over the public group mailing list(s) accessible to members and non-members alike.
... All private communication not during meetings will take place over the private group mailing list for members only.
... All public communication not during meetings will take place over the public group mailing list(s), real-time chats, issue trackers, or source code management systems and will be accessible to members and non-members alike.
Copy link
Member

@anajsana anajsana Jun 12, 2023

Choose a reason for hiding this comment

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

Suggested change
... All public communication not during meetings will take place over the public group mailing list(s), real-time chats, issue trackers, or source code management systems and will be accessible to members and non-members alike.
... All public communication not during meetings will take place over the public group mailing list(s), real-time chats, issue trackers, or source code management systems and will be accessible to members and non-members alike. Public communication must include all technical discussions and communications.

Choose a reason for hiding this comment

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

I am comfortable with this change provided technical is a bit better defined. We're working largely with technology companies so I'd argue almost every discussion could be construed as technical in nature because it will absolutely touch on technologies, e.g. stating that it is best practice that a project's ReadMe.md file on GitHub includes contact details for the project maintainers could be construed as a technical discussion.

IANAL, but if one were to take a broad interpretation of this clause, it would mean to me that nearly every communication taking place in TODO Group should be public. This would not be in keeping with current operations, such as the existence of the members only channel on the TODO Slack that is offered as a member benefit; people certainly discuss best practices for their project's GitHub presence in that channel, which is perfectly fine and appropriate.

Is there a way to add more detail to this clause without it becoming unwieldy or overly specific?

Copy link
Member

@anajsana anajsana Jun 12, 2023

Choose a reason for hiding this comment

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

Technical is everything related to contributing/participating in TODO project repos + meetings related to the activity of each of the repos. For instance:

Maybe we can be more specific on the kind of topics that refers to technical in the playbook, and leave a short sentence like the one suggested here?

Copy link
Member

Choose a reason for hiding this comment

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

Suggested change:

Project repo management, discussions, and workflows are public. To learn more about the different private and public communication channels, please go to [communication channel section]

TBD: Review what is written in communication channels to check if it's well enumerated.

@lhawthorn
Copy link

Have re-reviewed the inclusion of "shall" in the charter as per LF Legal and agree with reinstating it / not removing from the new charter draft.

Copy link
Member

@anajsana anajsana left a comment

Choose a reason for hiding this comment

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

clarify general member communication channels and public communication channels

GM-SC-CHARTER.adoc Outdated Show resolved Hide resolved
Co-authored-by: Georg Kunz <[email protected]>
Signed-off-by: Ana Jimenez Santamaria <[email protected]>
@anajsana anajsana merged commit 5ce36b8 into main Aug 2, 2023
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.

7 participants