Page MenuHomePhabricator

Consolidate and and deprecate metric definition pages
Open, In Progress, MediumPublic

Description

Background

Learning about foundation metrics is hard because they are documented across several, sometimes [[ https://www.mediawiki.org/wiki/Wikimedia_Product/Data_dictionary | outdated ]]wikipages, google docs and other information repositories. This causes confusion and makes it hard to find standardized information about how metrics are constructed and the caveats and details within them. Solving this documentation problem will allow us to both centralize existing knowledge of metrics and create a looking repository for future metric additions.

This project aims to take on several tasks:

  • Perform an inventory of all pages related to foundation metrics
  • Align approach and get buy-in from other metric producing teams (research, product analytics, community growth, fundraising analytics, WMDE)
  • Consult with technical writing team to design a central place, likely on-wiki where we can document metrics. This should include an template for both an overview page as well as metric details pages (perhaps borrow from ML team's model card approach)
  • Migrate information to central place and metric pages
  • Deprecate other pages and provide links and/or redirects back to central metric repositories.

Event Timeline

OSefu-WMF renamed this task from Consolidate and update metric definition pages to Consolidate and and deprecate metric definition pages.Nov 14 2024, 11:18 AM
OSefu-WMF updated the task description. (Show Details)
OSefu-WMF lowered the priority of this task from High to Medium.
OSefu-WMF moved this task from Incoming to FY24-25 H2 on the Movement-Insights board.

Update on progress:

Up next:

  • Reach out on key channels to learn of other documentation spaces for essential metrics

Progress update for the week

  • Reached out on key channels to learn of other documentation spaces for essential metrics.

Up Next

  • Deeper dive into the identified documentation spaces.
JAnstee_WMF changed the task status from Open to Stalled.Mar 28 2025, 6:01 PM
JAnstee_WMF changed the task status from Stalled to In Progress.Apr 25 2025, 6:40 PM

Related task that may have additional info about the data documentation state of affairs, things to consider for strategy, and types of data docs: T349103. I will also add as subtasks of this task some tasks I'm aware of that exemplify the issue of scattered metrics definitions.

Mayakp.wiki added subscribers: JAnstee_WMF, Mayakp.wiki.

I am claiming this task for evaluating scope and understanding feasibility of taking it up this FY25-26.

Mayakp.wiki moved this task from Next 2 weeks to Backlog on the Movement-Insights (FY25-26 H1) board.

Removing myself and adding this to backlog as i'll be focussing on T402576