Managing Research Software Projects



Contributions of all kind are welcome, from bug reports and suggestions for improvements to new material.

  1. All contributors must abide by our Code of Conduct.
  2. By submitting a pull request, you agree that your contribution can be reshared under the CC-BY License.

Making Decisions

This project uses Martha's Rules for consensus decision making:

  1. Before each meeting, anyone who wishes may sponsor a proposal by filing an issue in the GitHub repository tagged discuss. Proposals must be filed at least 24 hours before a meeting in order to be considered at that meeting, and must include:

  2. A quorum is established in a meeting if half or more of voting members are present.

  3. Once a person has sponsored a proposal, they are responsible for it. The group may not discuss or vote on the issue unless the sponsor or their delegate is present. The sponsor is also responsible for presenting the item to the group.

  4. After the sponsor presents the proposal, a sense vote is cast for the proposal prior to any discussion:

  5. If all of the group likes or can live with the proposal, it passes immediately.

  6. If most of the group is uncomfortable with the proposal, it is postponed for further rework by the sponsor.

  7. Otherwise, members who are uncomfortable can briefly state their objections. A timer is then set for a brief discussion moderated by the facilitator. After 10 minutes or when no one has anything further to add (whichever comes first), the facilitator calls for a yes-or-no vote on the question: "Should we implement this decision over the stated objections?" If a majority votes "yes" the proposal is implemented. Otherwise, the proposal is returned to the sponsor for further work.


  1. This project is hosted in Please file issues and create pull requests there.

  2. Slides use reveal.js with a few local additions in static/site.css and static/site.js. To keep things simple, this site does not use a static site generator.

License Code of Conduct Contributing Bibliography GitHub