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

Create communication-transparency.md #507

Merged
merged 1 commit into from
May 11, 2023
Merged
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
60 changes: 60 additions & 0 deletions focus-areas/project-and-community/communication-transparency.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
# Communication Transparency

Question: How transparent is project communication?

## Description

Communication transparency measures the degree to which project communication channels are available for all community members, if project transparency is aligned with project governance, and if project communication is visible and archived. Open source projects utilize various forms of communication; for example, communication may occur at in-person events or may occur using online messaging technologies. While different project parts may have different transparency needs (e.g., high-level leadership meetings and code of conduct issues may require less transparency), communication transparency and the policies around using appropriate channels for specific topics should be signaled to the community.

## Objectives

Open source projects require various degrees of transparency for collaboration to occur. Clear signals of communication transparency help community members understand where their engagement and contributions are best suited within a community. The degree to which project communications occur and if decisions are made via transparent communication can indicate how inclusive a project is. Improving communication transparency also helps new contributors, occasional contributors, and community members know where their contributions have an immediate impact and provide clearer paths to leadership within a community.

Transparency in discussions and decision-making is important so that community members understand how decisions came to be. For example, the number of communication channels may affect transparency because specific discussion topics may be difficult to find across different channels. Including community members in discussions and decision-making builds strong communities, gives voice to all types of contributors, and provides a potential path to leadership for community members.

## Implementation

### Filters

* Chat platforms (i.e., Slack)
* Email platforms
* Project repositories (i.e., GitHub and GitLab)
* In-person event recordings
* Meeting video recordings (i.e., Zoom)
* Meeting minutes
* Wikis

### Data Collection Strategies

* Survey the community about communication transparency. Potential survey questions for community members include:
* [Survey Likert Item 1-x] I am able to follow the conversations that are of interest to me that are occurring within the community.
* [Survey Likert Item 1-x] The project decision-making process is open and available to all community members.
* [Survey Likert Item 1-x] All of the communication related to specific project tasks occurs in the open (where appropriate).
* [Survey Likert Item 1-x] Previous discussions and conversations are archived and accessible.
* [Survey Likert Item 1-x] As a newcomer, I understand where and how decisions are made in the community.
* [Survey Likert Item 1-x] Communication channels are discoverable for newcomers.
* Regularly review the volume, types, and use of project communication channels. Work openly with project maintainers and community members to determine what communication channels are necessary and which communication channels can be removed, or improved upon. Data points to consider:
* Number of communication channels and volume per channel
* Types of communication channels (for example asynchronous chat versus synchronous virtual meetings)
* Number of meetings
* Time of the meetings
* Communication transparency alignment with published governance
* [Project Access](https://chaoss.community/?p=4891) - How accessible project communication channels are
* [Documentation Discoverability](https://chaoss.community/?p=3534) - If project documents are archived and available
* [Collaboration Platform Activity](https://chaoss.community/?p=3484) - The count of activities across the various channels
* Percent of communication that occurs in private channels (for instance on Slack)
* [Chat Platform Inclusivity](https://chaoss.community/?p=3536) - How do you review chat platform inclusivity for your community?

## References

* [5 Levels of transparency for open source communities](https://opensource.com/article/22/2/transparency-open-source-communities)
* [How to measure transparency to achieve security assurance](https://opensource.com/article/21/6/security-transparency)
* [Open Decision Framework](https://opensource.com/open-organization/resources/open-decision-framework)

## Contributors

* Kevin Lumbard
* Matt Germonprez
* Sean Goggins
* Elizabeth Barron
* Armstrong Foundjem