-
Notifications
You must be signed in to change notification settings - Fork 41
EESSI Governance #456
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
base: main
Are you sure you want to change the base?
EESSI Governance #456
Conversation
…we can do that in follow up PRs
@casparvl I've fixed some typos in casparvl#1 and casparvl#2. |
fix typo
fix some more typos
Oh yeah, thanks, merged! |
docs/governance/governance.md
Outdated
|
||
### 5.2 Removing Team Members | ||
<!-- Describe under what conditions someone may be removed (e.g., inactivity, conduct). --> | ||
Teams decide themselves decide the procedure to remove new Team members. As for the procedure of adding Team Members, the procedure to remove Team Members should reflect the sensitivity of the position. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Teams decide themselves decide the procedure to remove new Team members. As for the procedure of adding Team Members, the procedure to remove Team Members should reflect the sensitivity of the position. | |
Teams themselves decide the procedure to remove Team members. As for the procedure of adding Team Members, the procedure to remove Team Members should reflect the sensitivity of the position. |
docs/governance/governance.md
Outdated
TODO: This project follows the [Contributor Covenant](https://www.contributor-covenant.org/) Code of Conduct. | ||
|
||
## 8. Contribution Agreement | ||
TODO: Should refer to some Contribution Agreement. Is contributing only possible after signing this agremeent? If so, that should be stated here |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Linux projects have a standard approach here which doesn't involve signing a CA
TODO: Should refer to some Contribution Agreement. Is contributing only possible after signing this agremeent? If so, that should be stated here | |
TODO: Should refer to some Contribution Agreement. Is contributing only possible after signing this agreement? If so, that should be stated here |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hm, that sounds attractive, since it means we don't need a lawyer to draw up something for us :)
carefully hand-crafted ... aehm copiloted ... policies
…SSI softwares stack versions and individual software. Remove some duplicate statements
docs/governance/policies.md
Outdated
|
||
- EESSI is committed to providing a complete SBOM for all deployed software. | ||
- The SBOM should include versioning, licensing, and dependency information. | ||
- Preferred formats include SPDX or CycloneDX. |
There was a problem hiding this comment.
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 we can already meet the latter two points. If not, does it make sense to include them? I don't think so. Or at least we should make clear it's not currently the case, but is a long term goal.
## Enforcement | ||
|
||
Instances of abusive, harassing, or otherwise unacceptable behavior may be | ||
reported to the EESSI Steering Committee via direct message to one of the |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Note that I've changed a few "community leaders" into "EESSI Steering Committee". I think when it comes to reporting abuse, it should be very clear to whom that should be reported, and community leaders is extremely vague.
In other places, I feel 'community leaders' is a more appropriate term, e.g. where it comes to stating that community leaders have the right toe remove or edit commits that break the code of conduct - in this context, the community leader would be someone with a maintainer role.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
TODO: change to inidivdual mail addresses + add mail addresses steering committee members in the steering_committee.md.
- Governance: governance/governance.md | ||
- EESSI Policies: governance/policies.md | ||
- Code of Conduct: governance/code_of_conduct.md | ||
- Current Steering Committee: governance/steering_committee.md |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We should either set up an auto-redirect for eessi.io/docs/governance
to the moved steering_comittee
URL, or set up a simple index.md
in /governance
with bullets that points to the subpages.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Like this?
docs/governance/charter.md
Outdated
|
||
## 1. Mission | ||
<!-- Describe the project's purpose and the problem it addresses. Include a short mission statement. --> | ||
The EESSI project aims to build a common software stack that is: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Spell out EESSI in full the first time you use it + make it link to EESSI homepage?
Maybe also include logo on top of the page
docs/governance/charter.md
Outdated
- Cross-platform (laptop, Cloud VM, HPC Cluster) | ||
- Ready-to-use (served over the internet, just mount-and-go) | ||
- Optimized for a wide range of hardware architectures (CPU, GPU, interconnects) | ||
- Easily extendable |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should clarify what this means? Maybe also "customizable" (cfr. host injections)
Extra bullet for focus on Linux systems/VMs? (no native macOS/Windows)
docs/governance/charter.md
Outdated
## 2. Scope | ||
<!-- Define what is within the scope of the project and what is explicitly out of scope. --> | ||
EESSI will focus on creating a repository of software installations (software.eessi.io). This requires: | ||
- code to build and deploy new software into the repository |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Needs empty line above to fix formatting + capitalize bullet points
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
- code to build and deploy new software into the repository | |
- Scripts to automate the process of building and deploying additional software installations in `software.eessi.io` |
docs/governance/charter.md
Outdated
|
||
## 2. Scope | ||
<!-- Define what is within the scope of the project and what is explicitly out of scope. --> | ||
EESSI will focus on creating a repository of software installations (software.eessi.io). This requires: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
repository
is common technical terminology that usually means "package repository" (like RPMs), but actually means something else for us (CernVM-FS repository), so let's avoid that term (or be explicit), something like:
EESSI will focus on creating a repository of software installations (software.eessi.io). This requires: | |
EESSI focuses on creating a shared stack of software installations (`software.eessi.io`) that is distributed through a [CernVM-FS](https://cernvm.cern.ch/fs/) repository. | |
This requires: |
docs/governance/governance.md
Outdated
|
||
System administrators of systems providing EESSI are administrators of systems (such as, but not limited to cloud and HPC systems) that make the EESSI software stack available to their users. | ||
|
||
System administrators of systems providing EESSI are responsible for making sure that their system does not put any disproportional load on the public EESSI CernVM-FS infrastructure. Typically, this means that they are responsible for provisioning proper caching for their system, such as a private CernVM-FS Stratum 1, a proxy, and/or a properly sized local cache. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm not sure we can hold sysadmins responsible for anything.
How do they know that by making EESSI available they're agreeing to being responsible for this?
Also, how can they know that they've overloading EESSI's public infra? Will we notify them?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Reworded
|
||
### 2.8 End-Users | ||
|
||
End-Users are individuals that use any of the software provided by the EESSI software stack. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We should link to our terms of use here?
|
||
The Steering Committee is made up of community members with sustained and recognized contributions over time. Members take part in the Steering Committee as private individuals (i.e. they do not represent their employer(s)). | ||
|
||
Members will be removed from the committee if they resign. Furthermore, if a Member is inactive for 6 Months and does not reply to communication from the rest of the Steering Committee, the Member may be voted out by the other Steering Committee members (regular voting rules, as per section 6.3, apply). Finally, a Member may be voted out. In this case, the vote needs to be unanimous between the other Members. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Members will be removed from the committee if they resign. Furthermore, if a Member is inactive for 6 Months and does not reply to communication from the rest of the Steering Committee, the Member may be voted out by the other Steering Committee members (regular voting rules, as per section 6.3, apply). Finally, a Member may be voted out. In this case, the vote needs to be unanimous between the other Members. | |
Membership of the Steering Committe can terminate in three ways: | |
- A Member can resign | |
- A Member may be voted out. In this case, the vote needs to be unanimous between the other Members. | |
- If a Member is inactive for 6 Months and does not reply to communication from the rest of the Steering Committee, the Member may be voted out by the other Steering Committee members. In this case, regular voting rules, as per section 6.3, apply. | |
To be agreed on by the Steering Committee. I think the most practical is if we keep iterating / wait until every one of us has given an approving review