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

MAINT: Adopt new NiPreps' governance model #174

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions .maint/CONTRIBUTORS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# CONTRIBUTORS

This document lists those who have made contributions to the Project.
As per the contributor guidelines, they should be included by default in any publications derived from the Project.

If you are new to the project, don't forget to add your name and affiliation to the list of contributors here! Our Welcome Bot will send an automated message reminding this to first-time contributors.
Before every release, unlisted contributors will be invited again to add their names to this file (just in case they missed the automated message from our Welcome Bot).

| **Lastname** | **Name** | **Handle** | **ORCID** | **Affiliation** |
| --- | --- | --- | --- | --- |
| Dickie | Erin W. | @edickie | 0000-0003-3028-9864 | Krembil Centre for Neuroinformatics, The Centre for Addiction and Mental Health, Dept. of Psychiatry, University of Toronto |
| Esteban | Oscar | @oesteban | 0000-0001-8435-6191 | Dept. of Radiology, Lausanne University Hospital and University of Lausanne |
| Joseph | Michael | @josephmje | 0000-0002-0068-230X | The Centre for Addiction and Mental Health |
| Keshavan | Anisha | @akeshavan | 0000-0003-3554-043X | The University of Washington, eScience Institute |
| Lerma-Usabiaga | Garikoitz | @garikoitz | 0000-0001-9800-4816 | Basque Center on Cognition, Brain and Language (BCBL)<br />Department of Psychology, Stanford University |
| Mansour | Salim | @slimnsour | 0000-0002-1092-1650 | The Centre for Addiction and Mental Health |
| Pisner | Derek | @dPys | 0000-0002-1228-0201 | Department of Psychology, University of Texas at Austin, TX, USA |
| Richie-Halford | Adam | @richford | 0000-0001-9276-9084 | The University of Washington, eScience Institute |
| Rokem | Ariel | @arokem | 0000-0003-0679-1985 | The University of Washington eScience Institute |
| Cieslak | Matthew | @mattcieslak | 0000-0002-1931-4734 | Perelman School of Medicine, University of Pennsylvania, PA, USA |
| Kent | James D. | @jdkent | 0000-0002-4892-2659 | Neuroscience Program, University of Iowa |
| Veraart | Jelle | @jelleveraart | 0000-0003-0781-0420 | School of Medicine, New York University |
8 changes: 8 additions & 0 deletions .maint/FORMER.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
# FORMER MEMBERS

This document lists former contributors or maintainers who want to disengage from the Project, and seek to be dismissed in communications or future papers.
By adding your name to this list you are giving up on all your responsibilities to the project.
Should you desire to be considered back as a contributor or maintainer, please remove your name from this list and proceed as prescribed in the governance documents.

| **Lastname** | **Name** | **Handle** |
| --- | --- | --- |
57 changes: 57 additions & 0 deletions .maint/HOW_WE_WORK.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,57 @@
# How we work

This document can be used by the Project to define the Maintainers' operation workflows.
The document is completely optional, and it is a responsibility of the Maintainers to decide whether it is used, and if so, to keep it up-to-date.

<!--
Therefore, this is the entry point where Contributors will find information about:
* How to propose new features, changes to the code, changes to the documentation, etc., and what are the available paths to those activities depending on the estimated magnitude of the proposal (e.g., whether the project will have explicit Extension Proposal documents for major modifications).
* Whether the Project will make use of the GitHub Projects features, how new issues are triaged into milestones and projects, how issues are prioritized and labeled (e.g., whether the project adheres to the `impact:<low|medium|high>` and `effort:<low|medium|high>` labeling system).
* Establishing Maintainers roles, and making sure the `MAINTAINERS.md` file defines these roles and they are up-to-date in the Maintainers table.
* Open public meetings, and their frequency, where interested parties can join and participate in the definition of the roadmap, milestones and deliverables.
-->

<!-- OPTIONAL CONTENTS: Please revise or remove these lines -->
## Maintainers roles

The Project has designated three specific roles that Maintainers will cover:

* **(i)** *Lead-developer (LD)*.
The LD is responsible for ensuring the fluent communication between the Maintainers, keeps track of acquired responsibilities (e.g., review a pull-request), and anticipates and preempts roadblocks and conflicts that may make the work of other Maintainers harder;
* **(ii)** *SCRUM Guider (SG)*.
The SG is responsible for the triage of new issues, for communicating with the Maintainers and prioritize issues and features, and coordinate the concerted effort of Maintainers.
The SG may also lead meetings and keeps up-to-date the GitHub Project panel and the Milestones of this Project.
* **(iii)** *Outbound Coordinator (OC)*.
The OC is responsible for communicating with the maintainers of other projects (the project's OC, if the role is assigned) in the organization, ensuring that potential conflicts or incompatibility between releases across projects are resolved.
* **(iv)** *Advisory Member (AM)*.
AMs are invited maintainers to assist in fulfilling the maintenance duties and responsibilities by sharing their knowledge and resources with the board.
However, AMs are not directly responsible for the Project's direction and may or may not be involved in the decision making (which should be agreed upon by the MAINTAINERS board before starting their activities as AMs).
The Project may have as many AMs as the regular members see necessary to properly develop the Project.

## Project management

The Project uses the following management tools:

* **GitHub Milestones**
* **GitHub Project panel** -- which is located at https://github.com/orgs/nipreps/projects/3

**Maintainers' Meetings**.
The maintainers will meet at least once every fours weeks (monthly), although the LD may call for extra meetings when they might be necessary.
The agenda of the regular monthly meeting will be organized by the SG, who will also lead regular meetings.

**Open Meetings**.
Other meetings open to broader public can be proposed by any Maintainer, and the LD will be responsible of its organization in collaboration with the proponent(s).
As for any other decision, all Maintainers must agree on calling for a meeting.
These meetings can be organized to:

* brainstorm and engage the community in developing/updating the roadmap;
* gather feedback (e.g., after a recent new release);
* inform about changes in the Maintainers team, as well as recruiting new members;
* disseminate new important features;
* make announcements; etc.

## Setting priorities and triaging issues

This Project follows [the general recommendations of *NiPreps*](https://www.nipreps.org/community/CONTRIBUTING/#issue-labels).

<!-- OPTIONAL CONTENTS end here -->
14 changes: 14 additions & 0 deletions .maint/MAINTAINERS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
# Maintainers

This document lists the Maintainers of the project.
Maintainers may be added once approved by the existing maintainers as described in the `../GOVERNANCE.md` document.
By adding your name to this list you are agreeing to abide by the governance documents and to abide by all of the Organization's polices, including the code of conduct, trademark policy, and antitrust policy.
If you are participating because of your affiliation with another organization (designated below), you represent that you have the authority to bind that organization to these policies.

<!-- EXAMPLE: The current contents of the table are given for an example, please update. -->

| **Lastname** | **Name** | **Handle** | **ORCID** | **Affiliation** | **Role** |
| --- | --- | --- | --- | --- | --- |
| Dickie | Erin W. | @edickie | 0000-0003-3028-9864 | Krembil Centre for Neuroinformatics, The Centre for Addiction and Mental Health, Dept. of Psychiatry, University of Toronto |
| Esteban | Oscar | @oesteban | 0000-0001-8435-6191 | Dept. of Radiology, Lausanne University Hospital and University of Lausanne |
| Rokem | Ariel | @arokem | 0000-0003-0679-1985 | The University of Washington eScience Institute |
16 changes: 16 additions & 0 deletions .maint/PIs.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# PRINCIPAL INVESTIGATORS

This documents the key personnel who oversees the development of the Project and secures funding.
The names in this file are designated by the Organization's TSC at the time of accepting the Project under the Organization.
Changes to this file must be approved by the TSC.
When a PI ceases serving as such, by default, their name will be placed in the `CONTRIBUTORS.md` file should it not be there already.

By having your name in this list you are agreeing to abide by the governance documents and to abide by all of the Organization's polices, including the code of conduct, trademark policy, and antitrust policy.
If you are participating because of your affiliation with another organization (designated below), you represent that you have the authority to bind that organization to these policies.

| **Lastname** | **Name** | **Handle** | **ORCID** | **Affiliation** | **Position** |
| --- | --- | --- | --- | --- | --- |
| Esteban | Oscar | @oesteban | 0000-0001-8435-6191 | Department of Radiology, Lausanne University Hospital and University of Lausanne | |
| Rokem | Ariel | @arokem | 0000-0003-0679-1985 | The University of Washington eScience Institute, WA, USA | |
| Poldrack | Russell A. | @poldrack | 0000-0001-6755-0259 | Department of Psychology, Stanford University | |
| Satterthwaite | Theodore D. | | 0000-0001-7072-9399 | Perelman School of Medicine, University of Pennsylvania, PA, USA | |
7 changes: 7 additions & 0 deletions .maint/ROADMAP.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# ROADMAP

This document states how the roadmap is built, discussed and monitored by the Maintainers, with the engagement of Contributors and PIs.

For example, if the GitHub Projects feature is used, this document will contain a link to the corresponding Project and document who is responsible of managing the project, contacting Contributors and Maintainers to monitor the progress of activities, organizing meetings and discussions around the activities, etc.

This document may also indicate how the *milestones* feature of the project is used and, as for Projects, who is responsible of what coordination actions, their frequence, etc.
26 changes: 0 additions & 26 deletions .maint/contributors.json

This file was deleted.

50 changes: 0 additions & 50 deletions .maint/developers.json

This file was deleted.

5 changes: 0 additions & 5 deletions .maint/former.json

This file was deleted.

70 changes: 0 additions & 70 deletions .maint/paper_author_list.py

This file was deleted.

2 changes: 2 additions & 0 deletions .maint/requirements.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
click
fuzzywuzzy[speedup]
Loading