Community Health Score Dashboard by functionzz · Pull Request #4189 · mozilla/pontoon

functionzz · 2026-06-03T21:41:50Z

Community Health for Pontoon is currently manually managed via a series of scripts and Google Sheets by TPMs. This dashboard is meant to offload manual script running and give clearer pictures on community health.

The backend consists of a cron job that creates a snapshot of the current CHS state, with several variables tracked. This automation is run monthly, on the first of each month.

The snapshot, called LocaleChsSnapshot is then displayed thru various formats, namely the CHS Dashboard, Insights (per locale) and Global Insights (all locales).

TODO

~~Implement cron job with full data parity to existing scripts~~
~~Implement dashboard (confirm visuals with team)~~
~~Consider edge cases of various forms~~
~~Implement Locale,Global Insights graphs~~
~~Implement Locale,Global Insights changes~~

codecov-commenter · 2026-06-11T14:09:38Z

Codecov Report

❌ Patch coverage is 86.27451% with 56 lines in your changes missing coverage. Please review.
✅ Project coverage is 81.16%. Comparing base (6727ff3) to head (dfb2fc8).
⚠️ Report is 6 commits behind head on main.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Co-authored-by: Francesco Lodolo <flod@lodolo.net>

…tweak, rename active_contributors+active_contributors_200_approved, migrations

…tion

… existing table sorting

mathjazz

Nice work. Left a couple more nits.

Two more questions:

Are we adding tooltips to the table header? At least for "Contr. 1" and "Contr. 2" we probably should.
Should we add "All" / "Overall" to the "Team community health score" chart and only enable that option by default, same as on the pretranslation charts?

mathjazz · 2026-06-29T13:01:42Z

+              class="button"
+              id="edit-config"
+              href="{{ url('pontoon.insights.config') }}"
+              >Edit Configuration


It's not clear from the position of this button and the copy on the page it leads to, that it impacts the spreadsheet and the first chart.

Perhaps we should move them both to the same panel?

See this quick mockup, which obviously needs work:

functionzz · 2026-06-29T13:48:55Z

Tooltips are fine, I'll to all headers for consistency
I'll use All as an average to the team community health chart for consistency with the other 2 charts.

… average CHS, add tests

mathjazz

Nice work!

I feel like a title for the spreadsheet is missing. Something along the lines of "(Team) Community health activity"?

mathjazz · 2026-06-30T14:16:20Z

I feel like a title for the spreadsheet is missing. Something along the lines of "Community health activity"?

Thanks for the update! Note that this one is still missing.

mathjazz

I looked at most of the code and left comments inside. Please let me know if you have any questions.

One additional change we should do is create a more user friendly view when no locales are selected (just show the title of the table, "Please select communities to track" text and the EDIT CONFIGURATION button). You can also file a followup issue for this.

We should also (but this should be a followup for sure) drop the standalon configuration page and instead show locale configuration in the panel, with a UX pattern similar to Request more projects / new languages.

Co-authored-by: Matjaž Horvat <matjaz.horvat@gmail.com>

…d renames

mathjazz

Great work - let's land this!

Please file the followup issues mentioned above:
#4189 (review)

flodolo reviewed Jun 4, 2026

View reviewed changes

Comment thread pontoon/insights/chs.py Outdated

Comment thread pontoon/insights/chs.py Outdated

Comment thread pontoon/insights/chs.py Outdated

Comment thread pontoon/insights/chs.py Outdated

functionzz changed the title ~~Community Health Dashboard~~ Community Health Score Dashboard Jun 4, 2026

functionzz force-pushed the chs_dashboard branch from 0efa854 to 5aaf75c Compare June 11, 2026 14:02

functionzz force-pushed the chs_dashboard branch from 62d77d5 to 01de982 Compare June 24, 2026 03:51

functionzz marked this pull request as ready for review June 24, 2026 03:56

functionzz requested a review from mathjazz June 24, 2026 03:57

functionzz and others added 23 commits June 24, 2026 14:34

add chs cron job (not fully functional)

7592cd6

Update pontoon/insights/chs.py

474b32d

Co-authored-by: Francesco Lodolo <flod@lodolo.net>

Update pontoon/insights/chs.py

39ed6cc

Co-authored-by: Francesco Lodolo <flod@lodolo.net>

Update pontoon/insights/chs.py

db3fd41

Co-authored-by: Francesco Lodolo <flod@lodolo.net>

add env variables over hardcoded constants

a7f24ff

change LocaleChsSnapshot to LocaleHealthSnapshot, completion formula …

257014a

…tweak, rename active_contributors+active_contributors_200_approved, migrations

dashboard frontend base

a064a00

add configuration form + button + model changes, add staff authentica…

7df3b42

…tion

add score/default view, change fields to Decimal, reform css, improve…

9da467a

… existing table sorting

missing dashboard.html addition

8dd04bd

add no locale check, order locales by code

93d6417

full feature parity with scripts

56f737f

add community health activity charts to Locale and Global insights

56a5929

small snapshot logic, docs + DX changes

1ec9668

fix global insights tests

db983ac

fix typo

7014e00

Delete config.js

8ba21ff

fix small nits, add locales param to build_chs_snapshots

3370eb7

add snapshot + supporting function tests

9869c0a

rename columns, rename graphs, remove CHS Y-axis

c4b12d7

move /dashboard contents into /insights + renaming work

49b1681

renaming dashboards

c4ce014

doc changes

836bd41

mathjazz reviewed Jun 29, 2026

View reviewed changes

Comment thread pontoon/insights/templates/insights/config.html Outdated

Comment thread pontoon/insights/templates/insights/config.html

mathjazz reviewed Jun 29, 2026

View reviewed changes

apply merged dashboard + chs chart, add tooltips, add "All" field for…

c062ef0

… average CHS, add tests

functionzz requested a review from mathjazz June 29, 2026 17:53

mathjazz reviewed Jun 29, 2026

View reviewed changes

Comment thread pontoon/insights/templates/insights/insights.html Outdated

change title

176345a

functionzz requested a review from mathjazz June 30, 2026 13:10

functionzz added 2 commits June 30, 2026 10:30

add subheader

97c44c2

run make format

0f8fdf9

mathjazz reviewed Jun 30, 2026

View reviewed changes

functionzz and others added 12 commits June 30, 2026 12:07

Update documentation/docs/dev/deployment.md

aa8e9b6

Co-authored-by: Matjaž Horvat <matjaz.horvat@gmail.com>

Update documentation/docs/dev/deployment.md

316e438

Co-authored-by: Matjaž Horvat <matjaz.horvat@gmail.com>

Update pontoon/base/forms.py

c37f637

Co-authored-by: Matjaž Horvat <matjaz.horvat@gmail.com>

Update pontoon/insights/management/commands/collect_chs_snapshots.py

9315c1f

Co-authored-by: Matjaž Horvat <matjaz.horvat@gmail.com>

Update pontoon/insights/templates/insights/widgets/locale_list.html

489f10a

Co-authored-by: Matjaž Horvat <matjaz.horvat@gmail.com>

Update pontoon/insights/templates/insights/widgets/locale_list.html

869bc18

Co-authored-by: Matjaž Horvat <matjaz.horvat@gmail.com>

rename dashboard_locales to community_health_locales, rename form

2df3611

rename #view-toggle to #show-scores

7103cad

rename team-community-health-chart to community-health-chart

5df9c40

rename locale_list.html to community_health_table.html + other relate…

384919a

…d renames

move tooltip style

db8e884

remove unused css file from pipeline

9f89c11

functionzz requested a review from mathjazz June 30, 2026 16:55

move CommunityHealthLocaleForm

dfb2fc8

mathjazz approved these changes Jun 30, 2026

View reviewed changes

mathjazz merged commit 3222ef3 into mozilla:main Jun 30, 2026
5 checks passed

This was referenced Jul 1, 2026

Insights dashboard: drop dashboard configuration page in favor for in page locale selection #4271

Open

Documentation: global and locale insights need changing #4278

Open

Uh oh!

Conversation

functionzz commented Jun 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

codecov-commenter commented Jun 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

mathjazz left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

mathjazz Jun 29, 2026

Choose a reason for hiding this comment

Uh oh!

functionzz commented Jun 29, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mathjazz left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

mathjazz commented Jun 30, 2026

Uh oh!

mathjazz left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

mathjazz left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

functionzz commented Jun 3, 2026 •

edited

Loading

codecov-commenter commented Jun 11, 2026 •

edited

Loading

functionzz commented Jun 29, 2026 •

edited

Loading