User:TBurmeister (WMF)/GLAMToolhub

This page provides details of a session proposal by TBurmeister for WikiCon North America 2024.

What is the session?[edit]

An edit-a-thon focused on adding Toolhub annotations for GLAM tools.

Proposed length: 120 minutes
Link to proposal: https://wikiconference.org/wiki/Submissions:2024/Catalog-a-thon_for_GLAM_tools_in_Toolhub

Goals and benefits of the session[edit]

Goal 1: Improve the usability of Toolhub for finding GLAM tools and their documentation:

Improve the discoverability of GLAM tools in Toolhub by improving coverage and quality of attributes introduced in the v2 Toolhub taxonomy: audiences, tasks, content types, subject domains (i.e. GLAM subject domain).
Improve the findability of GLAM tool documentation by adding links to user and developer docs in Toolhub records. (This lays a foundation for future edit-a-thon work to improve the tool documentation itself.)

Goal 2: Expand the GLAM community's awareness of Toolhub and tool documentation best practices.

Goal 3: Support the GLAM community's goal to "Form an easy-to-share page that lists all GLAM tools in just one place."

Reasons for focusing on GLAM tools:

A specific scope is crucial for coordinating edit-a-thon-style event tasks;
Many lists of GLAM tools already exist and are relatively recent thanks to work like the Content Partnership Hub;
The GLAM community has a goal to single-source an easily-sharable list of tools; Toolhub could be a good solution for that, but only if the tools are in the catalog and annotated with useful metadata.
WikiCon NA usually has a strong presence of GLAM folks in attendance.
The GLAM community is passionate about and generally already understands the importance of metadata for discoverability :-)

Remixed logo image credits: Alexmar983, CC BY-SA 4.0 and BDavis (WMF), CC0, via Wikimedia Commons

Alignment with conference theme[edit]

This project highlights and expands on existing intersections between the GLAM community and the technical community (especially tool developers). Cataloging GLAM tools in Toolhub is an activity at the crossroads of technology, community curation, tool documentation, and GLAM community support. By encouraging GLAM community members to use Toolhub, this session will help us explore how a technical solution like Toolhub (a community-authored tool catalog) can support the goal of having an easy-to-share list of GLAM tools in one place...while also making that information more discoverable and maintainable than it might be on a wiki page or other format.

Session overview[edit]

Outline of what the process might look like:

Resources to be covered / prerequisites:

Phabricator account & basic usage
Wikimedia account + linked to Toolhub
Basic understanding of how and why Toolhub annotations are useful + guidance about how to decide which annotation values to apply (and how to not overthink it)

Pre-work to be done by organizer(s):

Create Phabricator tickets: one for each tool that appears on multiple of the lists of GLAM tools. Tickets should include:
- Link to the tool's Toolhub record
- Link to (or some abbreviated version of) the process instructions for the annotation tasks
Figure out how to have a leaderboard of some sort and track contributions during the conference
Prepare an intro/pitch deck for orienting participants to the project

Open questions[edit]

Can Toolhub handle ~50 (max) concurrent annotation editors making changes? Would we run into any IP blocking / spam-resistance tooling?

Resolved. bd808 says this would not be a problem

What are good existing options for logistics like leaderboards based on phab tasks?
- Toolhunt is great but wouldn't quite work for this use case because it doesn't (yet) support specifying the tool info field you want to edit.
- Comments from bd808 (copied from early draft doc):
  - https://toolhub.wikimedia.org/audit-logs might be useful to pull reports of changes made by during a date range by a user. The same information is available via the https://toolhub.wikimedia.org/api/auditlogs/ endpoint which would allow scripting of reports.
  - https://toolhub.wikimedia.org/recent and https://toolhub.wikimedia.org/api/recent/ is nearly the same data. The main difference is that the audit log feed contains information about things beyond content edits like account attachment and user permissions changes.

Lists of GLAM tools[edit]

Content Partnerships Hub lists:

Etherpad list of tools from workshop at European GLAMwiki Coordinators meetup (2022) (backup on Google)
Wikimedia content partnerships tools: Toolhub list
https://meta.wikimedia.org/wiki/Content_Partnerships_Hub/Software/List_of_tools
Tool Prioritization survey from end of 2022
Tool list – WMSE content partnerships hub

Other lists and resources relating to GLAM tools: