bokeh / bokeh

Interactive Data Visualization in the browser, from Python
https://bokeh.org
BSD 3-Clause "New" or "Revised" License
19.37k stars 4.19k forks source link

BEP 7: Decision making #10214

Closed bryevdv closed 4 years ago

bryevdv commented 4 years ago

ref: https://github.com/bokeh/bokeh/wiki/BEP-7:-Decision-Making

In order to apply for organizational GH sponsor status, I had to provide a model for group decision making. I would like to codify that model that I sent them (modulo refinements resulting from this discussion) publicly in BEP 7.

Rationale

This proposal aims to make the high level decision making of the Bokeh core team and NumFOCUS committee more transparent and accountable.

What is the process

The model I described was more or less this:

Official decision making follows a model of unanimous consent. Technical or financial proposals are put before the relevant team. Proposals may be put forth as Issues, PRs, topics on the Project Discourse, or as an email to all team members, as appropriate. If there is no comment or objection within first timebox, then the proposal is deemed to pass. If there is comment or objection, then discussion may proceed for the duration of a second timebox. If any objections are resolved n that time, the proposal is deemed to pass. Otherwise, I vote will be taken among all the team members.

The timebox durations may be stipulated by the proposer, however may not be shorter than three days.

When will this process apply

This process is not meant to impede day-to-day development. Standard work for bugfixes and small features will not normally come under this process, and only require an approval before merge. It is expected most recorded decisions will be financial matters.

Where are decisions recorded

I propose that a read-only public Google sheet be created to record official decisions. The sheet should have a row for each proposal gives:

The spreadsheet should be linked in the BEP document.

cc @bokeh/core

birdsarah commented 4 years ago

+1 from me.

bryevdv commented 4 years ago

@bokeh/dev I have made a first draft of the actual BEP page here:

https://github.com/bokeh/bokeh/wiki/BEP-7:-Decision-Making

Please leave and comments, suggestions for improvements, or questions here.

bryevdv commented 4 years ago

In the spirit of the process outlined there I will plan to mark the proposal as "Implemented" on July 10 July 15, if there is no comment or disagreement.

birdsarah commented 4 years ago

Read it. LGTM.

mattpap commented 4 years ago

In the spirit of the process outlined there I will plan to mark the proposal as "Implemented" on July 10, if there is no comment or disagreement.

I propose extending this time to the 15th (Wednesday), as I would like to have some more time to address my concerns regarding this proposal.

mattpap commented 4 years ago

Team members may express votes immediately. If enough +1 votes are expressed before the timebox is expired, then the proposal passes.

Even if there's an overwhelming vote for or against a matter, I think that the official acceptance or decline of a proposal should happen at the the end of the established timebox, otherwise there's a risk that unpopular opinion, which could potentially make others reconsider their position, may not be voiced or seen at all. This is especially given the short default (3 day) time frame.

bryevdv commented 4 years ago

Even if there's an overwhelming vote for or against a matter, I think that the official acceptance or decline of a proposal should happen at the the end of the established timebox, otherwise there's a risk that unpopular opinion, which could potentially make others reconsider their position, may not be voiced or seen at all. This is especially given the short default (3 day) time frame.

This is in fact my natural inclination, but let me explain why I changed it to that add that "short-circuit clause". Recently after a very-useful and productive (free) video call with a grant writing expert, some of us wanted to engage a few hours of (paid) services to help with the next CZI proposal in depth. They wanted some assurances of a contract from NF by end of week since the submission deadline itself is not that far off. Putting in three days, plus potential delay on the NF side could have pushed things well past that. However, I did want to go through process, and did send an email to the NF committee, and enough +1s came in quickly that I went ahead and told NF to get started on their end so we could meet the end of week deadline.

TLDR; occasionally there are actual time sensitive decisions that need to be made quickly (if they can be). So what is the right compromise here? Perhaps this short-circuit clause could apply only to the NF committee decisions? I expect the only time this may really ever come up is with financial matters.

I have updated the deadline to July 15

bryevdv commented 4 years ago

I have added a note regarding short-circuit vote permitted for expedient financial decisions, and marked the BEP as implemented.

github-actions[bot] commented 2 weeks ago

This issue has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs.