Skip to content

DOC: Add governance document draft - #163

Draft
mberz wants to merge 1 commit into
mainfrom
docs/governance_council
Draft

DOC: Add governance document draft #163
mberz wants to merge 1 commit into
mainfrom
docs/governance_council

Conversation

@mberz

@mberz mberz commented Jun 12, 2026

Copy link
Copy Markdown
Member

Proposed Changes

  • Add draft for the governance document

This draft was used as basis for the establishment of pyfar's first steering council.

Note: The use of markdown is only temporary and will be changed before the PR is finalized.

@mberz mberz moved this from Backlog to Drafting Phase in Weekly Planning Jun 12, 2026
@mberz
mberz requested review from ahms5, f-brinkmann and sikersten June 26, 2026 09:22
@mberz

mberz commented Jun 26, 2026

Copy link
Copy Markdown
Member Author

@f-brinkmann @sikersten @ahms5 , Could you please check if there's something I forgot here?

@mberz mberz changed the title [WIP] DOC: Add governance document draft DOC: Add governance document draft Jun 26, 2026

@sikersten sikersten left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Thank you very much @mberz, very nice draft!
I have one more important question on the DEPs, otherwise only minor points.
Once we finalize, we should check for inconsistent capitalization.

### What Reaches the Steering Council

In practice, most decisions in the pyfar project will be resolved by Maintainers via lazy consensus or informal vote.
**The committee is involved when:**

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
**The committee is involved when:**
**The council is involved when:**

In practice, most decisions in the pyfar project will be resolved by Maintainers via lazy consensus or informal vote.
**The committee is involved when:**

- A DEP has **cross-package or project-wide impact** — for example, introducing a new shared data structure, changing a convention adopted by all packages, or deprecating functionality that other packages depend on

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

changing a convention adopted by all packages

How should we treat the template package in this context? It has been used in the past to establish such conventions.

**The committee is involved when:**

- A DEP has **cross-package or project-wide impact** — for example, introducing a new shared data structure, changing a convention adopted by all packages, or deprecating functionality that other packages depend on
- A DEP proposes a **large new feature or new package** — meaning functionality that significantly expands a package or the project, requires substantial development effort, or has broad implications for the user-facing API

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

A DEP proposes a large new feature or new package

Not sure about this point, since we have not fully defined DEPs yet. Is there any DEP that does not need to be discussed by the council? If not, I would suggest writing here that every DEP needs approval by the council. The explanations for what a DEP does can then be implemented by linking to DEP0.

- A DEP has **cross-package or project-wide impact** — for example, introducing a new shared data structure, changing a convention adopted by all packages, or deprecating functionality that other packages depend on
- A DEP proposes a **large new feature or new package** — meaning functionality that significantly expands a package or the project, requires substantial development effort, or has broad implications for the user-facing API
- A question of **removing or significantly altering** long-standing functionality that many users rely on
- A DEP proposes a **governance change** — modifying roles, voting rules, the DEP process, or the Code of Conduct

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

See comment above. If we agree that every DEP needs approcal by the council, this is point is just and obsolete explanation of what DEPs are for.

- Maintainers across packages **cannot reach consensus** after discussion
- A decision has legal, financial, or external relations implications

### Composition

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Should we add a point, what is required to change the rules for this composition? A DEP?

- Organizing and preparing Steering Council meetings
- Ensuring the composition of the Steering Council stays current

### Selection Process

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

We should add a point at which point in time the selections happen and who is deciding that. Is it a special meeting, how is it announced?


### Stepping Down & Emeritus Status

Members who step down from the Steering Council are recognized with **emeritus status**, acknowledging their past contributions. Emeritus members may attend meetings and contribute to discussions but do not hold voting rights.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Suggested change
Members who step down from the Steering Council are recognized with **emeritus status**, acknowledging their past contributions. Emeritus members may attend meetings and contribute to discussions but do not hold voting rights.
Members who step down from the Steering Council are recognized with **emeritus status**, acknowledging their past contributions. Emeritus members may attend meetings and contribute to discussions but do not hold the rights of an active council member.

To remove confusion with the voting as part of the selection process


### Expected Conduct

Steering Council members are expected to participate in votes, particularly on major DEPs and governance decisions. If a member becomes inactive in the project for a period of 6 months, they will be considered for removal from the Council. Before removal, inactive Member will be approached to see if they plan on returning to active participation. If not, they will be removed immediately upon a Council vote.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

I would suggest to add giving them the option to step down as an alternative to simply removing them, such that they reach the emeritus status.

### Expected Conduct

Steering Council members are expected to participate in votes, particularly on major DEPs and governance decisions. If a member becomes inactive in the project for a period of 6 months, they will be considered for removal from the Council. Before removal, inactive Member will be approached to see if they plan on returning to active participation. If not, they will be removed immediately upon a Council vote.
Sustained absence from votes without notice may prompt a discussion about whether a member wishes to continue in the role.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Can you clarify what you mean with this point? Present in the council meeting but not voting, or not being present in the council meetings?

@github-project-automation github-project-automation Bot moved this from Drafting Phase to Require review in Weekly Planning Jul 31, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Status: Require review

Development

Successfully merging this pull request may close these issues.

2 participants