Skip to main content

Communicating via GitHub

GitHub Organization Membership

The OpenRefine project uses a GitHub organization to manage collaboration across its repositories.

Contributors are invited to join the OpenRefine GitHub organization based on their level of involvement and the responsibilities they take on within the project.

Being a member of the GitHub organization allows contributors to be assigned to issues, participate in team-based workflows, and collaborate more easily across OpenRefine repositories.

The organization includes teams with different responsibilities that reflect how work is coordinated across the project. Details about governance, decision-making, and responsibilities are documented in the OpenRefine governance documentation.

Notifications

As a member of the organization, GitHub subscribes you automatically to a lot of notifications about everything that is happening in the project. For most people, this will generate much more noise than desired.

We recommend new members of OpenRefine's GitHub organization apply some GitHub configuration settings to help them integrate into the project smoothly.

Go to the OpenRefine repository, click on "Unwatch" and pick "Participating and @mentions". This will ensure that you only get notifications in discussions in which you left a comment, or if you were explicitly pinged.

Screenshot of notification settings on GitHub, where 'Participating and mentions' is selected

We encourage you to do the same for any other repository which generates unwanted notifications in your feed. This will help you ensure your GitHub notifications stay relevant and help you get involved in OpenRefine, focusing on the topics that you care about.

Publicizing your membership

By default, your membership of the OpenRefine project is kept hidden. We encourage you to make it public by going to the list of members of the OpenRefine organization, looking for your own user account there, and switching from "Private" to "Public".

Screenshot of the two visibility choices (private and public) for organization membership on GitHub

This will include you in the list of project members and display an OpenRefine badge on your GitHub profile:

Screenshot of an OpenRefine badge on a GitHub profile