Collaboration Tools
This document outlines the communications tools available for Open Mainframe Project hosted projects and working groups.
Open Mainframe Project leverages the tools provided by the LFX Project Control Center (PCC) for maintaining committee member lists, scheduling meetings, configuring mailing lists, and making community meetings publicly available. The LFX Project Control Center is a tool built and maintained by the Linux Foundation for use by the Open Mainframe Project and its hosted projects and working groups. Access to PCC for hosted projects and working groups for management of meetings and committees can be granted by making a support request here.
Committee Management
Hosted projects and working groups will have a primary committee set up in PCC. Larger hosted projects and working groups may have subcommittees or groups. The naming convention for committees and PCC Committee Type will be as follows.
Name | PCC Committee Type | Description |
---|---|---|
Techincal Steering Committee (TSC) | Techincal Steering Committee | Primary committee for hosted projects |
Working Group (WG) | Working Group | Primary committee for working groups |
subcommittee name |
Other | Any additional subcommittees |
The LF staff will set up the primary committee; subcommittees can be set up by the hosted project and/or working group themselves or the LF Staff if desired. The primary committee will be associated with any mailing lists of the hosted project or working group, meaning that they will be automatically added to those mailing lists.
Projects must maintain their committee members in LFX PCC and are expected to review for accuracy at least every three months
Adding people to a committee
Committee members are named individuals who have been appointed or elected to the committee per the hosted project’s Technical Charter and any relevant hosted project or working group policies. Each hosted project and working group should detail the requirements for membership and distinguish voting from non-voting roles.
Instructions for adding individuals to a committee in PCC can be found here. The specific settings for adding individuals are as follows.
Field | Value |
---|---|
Appointed By | For TSCs, this would be Vote of TSC Committee . For Working Groups and sub-committees, pick Community |
Voting Status | Generally, this should be Voting Rep , though if you have non-voting roles on the committee, select Other |
Voting Start Date | The date when the individual’s voting status began on the committee |
Voting End Date | The date when the individual’s voting status is set to end if that is known. Most often, this will be blank unless the person is elected to the committee for a defined term |
Role | Select if the individual holds a specific role on the committee, such as Chair . If not, pick None |
Role Start Date | The date when the individual started in the role if the Role selected is not None |
Role End Date | The date when the individual is planning to end their term in the role if known and if the Role selected is not None |
Removing people from a committee
Instructions for removing individuals from a committee are here. Please ensure that you establish, document, and follow the committee’s processes for removing individuals from a committee.
Meetings
Hosted projects and working groups will use the LFX PCC Meeting Management service for all virtual and hybrid project meetings. This tool leverages Zoom, adding helpful features to reduce the overhead for project communities in managing their meetings.
- Ability to automatically invite committee members to a meeting, including sending out invites for existing meetings automatically when a committee member is added and removing the invite when the committee member is removed.
- Automated meeting recording and transcription, making those available to named meeting participants via their LFX Individual Dashboard and, more broadly, via the Public Meeting Calendar if the meeting is set to
Public
. Meeting attendance is taken automatically and attached to the meeting itself. Attendance is reportable to gauge participants’ engagement.
Adding meetings
Instructions for creating a meeting in PCC can be found here. Specific guidelines for hosted projects and working groups should be as follows.
- Generally, all hosted projects and working group meetings should have
Make Meeting Public
checked andRestricted
unchecked, as those meetings are public by default. Occasionally, meetings related to security vulnerability review or other sensitive topics may be held; in those cases,Make Meeting Public
should be unchecked andRestricted
checked. - Associate a
Committee
with the meeting to ensure that those committee members are automatically added. Other non-committee members can join using the meeting link and request that a meeting invite be sent to them.
Changing meetings
Instructions for changing meetings can be found here. Specific guidelines for hosted projects and working groups should be as follows.
- Avoid changing meetings less than 24 hours before the meeting starts. If you need to do this, please get in touch with all participants to inform them about the cancellation.
Cancelling meetings
Instructions for canceling meetings can be found here.
Calendar
Each hosted project and working group has a Public Calendar that can be directly pointed to or embedded in an existing web page. Instructions for getting the link for the hosted project or working group Public Calendar can be found here. Note that the LF Staff sets up a subdomain forward if the project has a primary domain setup using the format https://calendar.DOMAINNAME
.
All public meetings for hosted projects and working groups are posted on the Community Calendar.
Meetings that an individual is directly invited to can be found in the ‘Meetings’ section of that individual’s LFX Individual Dashboard; instructions can be found here
Best Practices
To help individuals not be inundated with calendar overload, try to follow these guidelines:
- Make sure to make meeting invite changes ( including cancellations or reschedulings ) more than 24 hours in advance, as many calendaring clients wait to update. The best practice is to email the respective committee’s mailing list or email the list of meeting attendees in PCC to inform the group of the cancellation.
- Instruct invitees to manually remove old entries when provisioning a new series of recurring meetings. Occasionally, we will see some calendaring clients not removing these automatically.
- Ensure the meeting description includes an agenda or a link to the agenda.