2025 Barcamp Session Proposal: Contributor Experience Discussion

Description

This session would be an opportunity to discuss the experience, good or bad, of contributing to OpenRefine. This doesn’t need to be limited to GitHub contributions; experience reports of engaging with the developer community at large are very welcome! If you have opened or commented on an issue or pull request, discussed technical topics on the forum, or have engaged with the developer community in some other way, you’re invited to talk about your experience. Please share what went well and especially what you think could be improved.

I will also share some statistics around contributions in 2025: number of new contributors, issues and pull requests opened and closed, etc.

Format

Brief presentation on contributor statistics with group discussion to follow

If you’re interested

Please feel free to comment below with anything in particular you’d like to discuss or contribution metrics you’d like to see presented!

3 Likes

Etherpad from the call: Etherpad

clean up notes from the pad

Rory shared a dashboard summarizing contribution activity in the OpenRefine repository, including metrics such as the number of issue openers per year and pull requests submitted.

Some metrics of interest that were discussed:

  • whether pull requests were merged
  • time taken to merge pull requests
  • distinguishing translation contributions (via Weblate) from code contributions

The metric focuses on the main OpenRefine repository and does not include contributions to the website, where documentation work takes place.

Issue discussions and contribution pathways

Participants discussed the effort required to move conversations from community spaces (such as the forum or Wikimedia-related Telegram channels) into GitHub issues.

Forum and Telegram discussions have a lower barrier to entry, and users often start discussions there because they are unsure whether they have encountered a bug or simply something they do not yet understand.

This raised the question of whether the project should provide guidance on how to open issues.

  • Nicolas suggested creating a reference document describing what makes a good issue or support question.
  • This could reuse or adapt templates already used in the forum support section.

Interest in regular contributor calls

The possibility of organizing regular contributor calls was discussed.

  • Tom noted that many developers prefer asynchronous communication rather than meetings.
  • Nicolas also mentioned already having many meetings and limited availability for additional calls.

Recognizing translators

Participants discussed whether translators should be highlighted more prominently in release notes.

Suggestions included:

  • Acknowledging translators explicitly in releases
  • Using releases to help distribute updated translations to the community

Because OpenRefine releases updates frequently, translations are usually updated quickly. This is not the case for extensions that release less often.

A translation dashboard showing the current translation backlog could also be useful.

Wikidata Lexemes example

A participant raised the example of Wikidata Lexemes integration. They expressed interest in contributing but noted that they are not a developer and the topic is relatively niche.

The suggestion was that preparing a requirements document would help clarify the scope and enable a technical assessment, as such work could involve multiple projects (including Wikidata tooling and OpenRefine).

Translation and documentation

The discussion also touched on how documentation should be organized and translated.

  • Srihari suggested that documentation should primarily live on the OpenRefine website, since that is where most users expect to find it.
  • Guides and tutorials should also be hosted there.
  • The GitHub wiki is less visible and not widely known by users.

Tom and Rory supported this view.

Some existing wiki pages could be archived or removed, with their content migrated to the website. Producing guidelines for migrating documentation pages was proposed as a possible community project. See #551

@Rory cleaning up the note I realized that I do not have a copy of the dashboard or a recording of the call. Please feel free to share screenshot or link the code to generate the status. Thank you