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

2024 governance update #7023

Draft
wants to merge 4 commits into
base: master
Choose a base branch
from
Draft

2024 governance update #7023

wants to merge 4 commits into from

Conversation

magdmartin
Copy link
Member

This PR follows discussions on the forum. The goal is to document how the project currently operates.

What changed

As discussed I

  • Added Apache meritocratic model back
  • Clarified the process for voting new members into the different role
  • Clarified how funds are managed.
  • Introduced the Core Developer Group
  • Remove the Steering Committee

I also took the opportunity to introduce the following role

  • Clarify language in the Code of Conduct
  • Code of conduct committee
  • Designer

What will be updated in a second phase

  • I left the Project Manager description as-is. The new scope is currently being discussed with the Advisory Committee.
  • I have documented the current process for renewing the Advisory Committee. Once we finalize the process, I propose we update the Governance to make it more transparent.
  • Mention the mission, vision, and values. We need to add them first on the website and reference them in the Governance and Code of Conduct document.

wetneb and others added 2 commits November 28, 2024 19:07
As mentioned [on the forum](https://forum.openrefine.org/t/transitioning-out-of-the-project/1879), I am in the process of reducing my involvement in OpenRefine. Leaving the advisory committee is one step of that process. I intend to continue development and other activities until the end of March, but I don't need to be in the committee for that.

Perhaps it would be worth thinking about onboarding new members on the advisory committee.
@magdmartin magdmartin requested review from tfmorris, Abbe98, Ainali, AtesComp and ej2432 and removed request for AtesComp November 29, 2024 22:44

All project participants abide by the [Code of Conduct](https://github.com/OpenRefine/OpenRefine/blob/master/CODE_OF_CONDUCT.md).
Decision-making is done based on user consensus following open discussion (i.e., using OpenRefine's [discussion list](https://forum.openrefine.org/c/dev/8) and [issue list](https://github.com/OpenRefine/OpenRefine/issues?state=open)). No decisions about the project’s direction, bug fixes, or features may be made in private without community involvement and participation. Discussions must begin at the earliest possible point on a topic; the community’s participation is vital during the entire decision-making process.
Copy link
Member

Choose a reason for hiding this comment

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

No decisions about the project’s direction, bug fixes, or features may be made in private without community involvement and participation.

This is not really align with our practice or the Apache Decision Making process. There are a lot of reasons to decide certain things in private. Security, actual consensus making, etc. If we want to keep it simple lets just link to the Apache document without trying to patch it?


Anyone with an interest in the project can join the community, contribute to the project design, and participate in the decision making process. This document describes how that participation takes place.
All project participants abide by the [Code of Conduct](https://github.com/OpenRefine/OpenRefine/blob/master/CODE_OF_CONDUCT.md).
Copy link
Member

Choose a reason for hiding this comment

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

Is the CoC up to date? Last time (which I know of) it was "enforced" by an AC member not listed in that doc...

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 the members could be refreshed (for instance, as Jessica has left CS&S), but to me it still reflects the current state of the committee. Are you worried that the CoC committee could be just a sock puppet of the AC without actual independence and agency? If you are referring to me as a former AC member, last time I reached out to the CoC about a particular situation, they disagreed about my assessment of that situation and followed their own judgment, which I would take as a good sign of the committee's independence.

That being said, it's an open question to me how to keep a CoC committee active for such a small project because it only gets woken up once in a blue moon, making it hard to keep the practice and understandings of the tasks alive. Surely there is room for improvement, but that's something we should rather do in another PR I would say.

Copy link
Member

Choose a reason for hiding this comment

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

Whether or not the CoC is mentioned here or not doesn't change its status I would hope. This is just a link for convenience.

Copy link
Member

Choose a reason for hiding this comment

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

@Ainali the CoC contains quite a lot about governance and it's currently very badly aligned with this document, who are considered a "project leader"? can the CoC group enforce rights-changes against contributors? It's all governance, and with the ACs history of weaponizing it, I would ague it's rather important to get it right.

Copy link
Member

Choose a reason for hiding this comment

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

@Abbe98 : “with the ACs history of weaponizing it”
What do you mean? That the CoC has been use by the AC?

“project leader”: do you mean project leadership? Because that seams to me to be appropriate even if not defined.

The CoC is pretty general and more guidelines than a checklist/every step procedure. It did suits us, the project, in the last 4 years that I've participated in the committee.

Regards, Antoine


Anyone with an interest in the project can join the community, contribute to the project design, and participate in the decision making process. This document describes how that participation takes place.
All project participants abide by the [Code of Conduct](https://github.com/OpenRefine/OpenRefine/blob/master/CODE_OF_CONDUCT.md).

### Users
Copy link
Member

@Abbe98 Abbe98 Nov 30, 2024

Choose a reason for hiding this comment

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

These sections create expectations around people and try to sort them into buckets of with little to no relevance to the governance. I would suggest limiting these sections to match those of GitHub contributors(the actual user rights), it would simplify this a lot while staying true to the actual state of order.

Copy link
Member

Choose a reason for hiding this comment

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

Your comment implies that this governance file should be limited in scope to just the GitHub organization. That may be one way to do it, but then I think we need another governance file covering the entire project/community and not just the parts happening on GitHub. While each of the files may be simplified, it will be harder to get an overview both of the actual state and the intended state.

Copy link
Member

Choose a reason for hiding this comment

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

@Ainali you don't need to sort people and their work into buckets to have a governance document, removing these sections wouldn't change the policy at all.

I do argue for the governance document to be split as the current approach makes things unclear and the later sections contradicts the former ones.


#### Current list of Steering Committee members
There is currently no Steering Committee as the project is looking for a better format. See discussion [Fwd: Steering committee being disbanded?](https://forum.openrefine.org/t/fwd-steering-committee-being-disbanded/430/) and [Proposition to create OpenRefine Ambassador Council](https://forum.openrefine.org/t/proposition-to-create-openrefine-ambassador-council/462)
**How to join the Code of Conduct Committee?**. Committers are voting-binding members; they select and elect new members through a voting process. Nominations should be submitted to the [developer discussion list](https://forum.openrefine.org/c/dev/8), where contributors can nominate themselves or other contributors. See the New Member Election section below for more details.

### Advisory Committee
Copy link
Member

Choose a reason for hiding this comment

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

From here on I think the document do no longer describe the governance of the project but instead the relationship between CS&S and the AC. This is clearly not aligned with the Apache Decision Making process nor do it concern the open source project.

I would suggest moving this somewhere else.

Copy link
Member

Choose a reason for hiding this comment

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

To me the AC is currently a component of the project, so it makes sense that it's described in this document. I think @magdmartin's intention is to first update the governance document to reflect the reality of the current situation, and currently the AC does feel like a part of the project to me, so I would keep it. The intention is not to set this in stone, but do incremental updates as the subject is contentious.

There could be further changes later on: changing the way the AC works, or deleting it entirely and leaving CS&S to go back to being just a GitHub project. I think it's best to discuss those separately.

Copy link
Member

Choose a reason for hiding this comment

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

and currently the AC does feel like a part of the project to me, so I would keep it

This is probably because you are a part of it? You are the only notable GitHub contributor who are also a part of the AC...

Adjust reference to the Member Election section
@magdmartin
Copy link
Member Author

@Abbe98, thank you for re-engaging the conversation regarding OpenRefine governance.

As I mentioned when opening the pull request, the goal is to make minimal changes to accurately document how OpenRefine operates today, even if it is flawed. For more significant changes to the governance structure, I recommend starting with important questions and suggestions that have yet to be addressed in the forum, starting from this message and following ones. However, please note that with year-end activities and the current hiring effort, I will not be able to engage meaningfully in those conversations until late January at best.

For now, I would prefer not to delay these changes as they document where we had a consensus and address some outdated aspects of the project.

@Abbe98
Copy link
Member

Abbe98 commented Dec 2, 2024

the goal is to make minimal changes to accurately document how OpenRefine operates today, even if it is flawed

@magdmartin both my comments regarding the "people buckets", the CoC, and the AC are about how OpenRefine operates today. If you want to criticize one of my points please do it in the threads instead of trying to bulldoze my concerns.

@magdmartin
Copy link
Member Author

@Abbe98 I believe your comments are outside the scope of this pull request, and I will not address them here. In my previous message, I welcomed your input and suggested it might be more suitable for a forum discussion. Additionally, some of your messages come across as quite harsh. I encourage you to adopt a less accusatory tone if you want your arguments to be more convincing.

@Abbe98
Copy link
Member

Abbe98 commented Dec 3, 2024

I think my comments deserves more than a plain refusal to comment on the subjects at hand, especially given the broader subject of governance. However, given your reservation I will reach out to you in private so that we can resolve any issue that concerns you.

- Merge pull requests
- Publish releases
- Review security vulnerability reports
- Provide long-term project vision with the Advisory Committee team
Copy link
Member Author

Choose a reason for hiding this comment

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

Suggested change
- Provide long-term project vision with the Advisory Committee team
- Provide long-term project vision with the community

This is done via public discussions on the forum, on github, using various user survey (see the feature survey 2024 for example) and roadmap exercise (see barcamp notes) or proposed roadmap

Since January 2020, OpenRefine is a member project of [Code For Science and Society](https://codeforscience.org/) (CS&S).
## Member Election
When voting for new Committers, Core Developer Group or Code of Conduct Committee members, start a new thread with a subject line starting with `[VOTE]` to indicate that a formal vote has been requested on the [developer discussion list](https://forum.openrefine.org/c/dev/8) and use the `election` tag. In your message, indicate
* The name of the individual nominated with its GitHub or forum username
Copy link
Member Author

Choose a reason for hiding this comment

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

Suggested change
* The name of the individual nominated with its GitHub or forum username
* The name of the individual nominated with their GitHub or forum username

## Member Election
When voting for new Committers, Core Developer Group or Code of Conduct Committee members, start a new thread with a subject line starting with `[VOTE]` to indicate that a formal vote has been requested on the [developer discussion list](https://forum.openrefine.org/c/dev/8) and use the `election` tag. In your message, indicate
* The name of the individual nominated with its GitHub or forum username
* For which group you are nominating this person (Committers, Core Developer or Code of Conduct 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.

Suggested change
* For which group you are nominating this person (Committers, Core Developer or Code of Conduct Committee)
* Which group you are nominating this person (Committers, Core Developer or Code of Conduct Committee)

Only eligible voters have a binding vote. Votes are expressed as
- +1: yes
- 0: I will not oppose the nomination.
- -1: no, I oppose the nomination. All -1 votes must be justified.
Copy link
Member Author

Choose a reason for hiding this comment

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

Suggested change
- -1: no, I oppose the nomination. All -1 votes must be justified.
- -1: no, I oppose the nomination. All -1 votes must be explained.


### Manage funds
Voting is open for 72 hours to provide an opportunity for all concerned persons to participate, regardless of their geographic location.
Copy link
Member Author

Choose a reason for hiding this comment

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

Suggested change
Voting is open for 72 hours to provide an opportunity for all concerned persons to participate, regardless of their geographic location.
Voting is open for seven days to provide an opportunity for all concerned persons to participate, regardless of their geographic location.

Increasing to seven days as per @thadguidry request. Based on how frequently a number of committers and core contributors interact, I think it makes sense to increase it so we do not create artificial pressure to vote.

@magdmartin
Copy link
Member Author

Following recent conversation (Dec 12 Advisory Committee call and forum conversation) I will update the governance to

  • Extract Policy into a new section (within the same file). This aims to separate governance and how different committee operates.
  • The governance will focus on the different Roles and responsibilities. It will link to the relevant policy that applies to the group
  • The Policy will include
    • Member election
    • Conflict of interest
    • Managing funding

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