Communication Tools and Processes - magma/magma GitHub Wiki

This page describes the communication tools, channels and processes the community is using to keep in touch with each other and discuss project related matters.

Communications Channels

Magma Meetings

Magma meetings are listed in our Calendar. Everybody is welcome to drop in to each of these meetings and get a feel for the topics of discussion - or to pose their own questions and ideas and start participating. Most meetings have meeting notes linked in the calendar information - in which you can add your own agenda items should you like to add topics to the meeting discussion.

Magma Technical Steering Committee (TSC) Meetings

This is one of the regular meetings, which we call out here as it has a special role in various procedural operations of the Magma community. The Magma TSC, as one of the governance bodies of the project, is described on the project's website and defined in the Magma Core Foundation (MCF) Governance. You might attend the TSC meetings in order to:

  • Reach out for help or attention on your outstanding Magma Proposal
  • Ask questions or raise concerns generally
  • Overhear others discussing proposals, Governance votes, etc

Magma Slack Instance

The main platform for synchronous communication between contributors is Slack. To create a Magma Slack account see the Accounts Setup sub-section of this Wiki. Slack is the preferred channel for:

  • Unicast communications between team members and CODEOWNERS (1:1 or sub-group)
  • Magma sub-project status and coordination channels
  • Quick, non-persistent and non-discoverable communications generally
  • Communications with CODEOWNERS (#governance-codeowners channel)
  • Communications with the Technical Steering Committee (TSC) (#governance-tsc channel)

Because Slack is not very durable or searchable - Slack is not the preferred mechanism for certain types of topics and discussions. After perhaps a brief discussion in Slack, the following types of communications should probably move off of Slack:

Github Issues

Magma uses GH Issues for a variety of purposes, including but perhaps not limited to:

Github Discussions

GH Discussions may be a good starting point for certain types of questions. They are more durable and discoverable. If you have a problem, you might start by searching here, or post a question. If you want to propose some change to Magma, you might also begin here to see if there is a related historical discussion - or open a discussion yourself to get feedback on the idea before beginning the Proposal Process.

Mailing Lists